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PREFACE 



The second edition of the MPE V/E Tables Manual describes the internal table organiza- 
tion of the MPE V operating system. It is intended for the technically sophisticated user 
with Privilege Mode capability. We strongly discourage modifying the table structure be- 
cause you may destroy the operating system. The following caution applies: 



CAUTION 



The normal checks and limitations that apply to the 
standard MPE users are bypassed in Privileged Mode. It 
is possible for a Privileged Mode program to destroy file 
integrity including the MPE operating system software 
itself. Upon request Hewlett-Packard will investigate 
and attempt to resolve problems resulting from the use 
of Privileged Mode code. This service is available on a 
time and materials billing basis. However, 
Hewlett-Packard will not support, correct, or attend to 
any modifications of the MPE operating system 
software . 

The major highlights of this edition include: 

. A new chapter (24), "Native Language Support". It includes all of the character sets to support 
the installed languages. 

. Expanded Chapter 1 5 . It now includes Native Language Support Application Message Facility. 

• A new table, DEFDATA Table. It describes the default configuration for for HP-IB devices. This 

table is located in Chapter 1 6 . 

• A new table, Process Job Cross Reference Table. It determines the job/session main process 

(Command Interpreter) for any process on the system. This table is located in Chapter 8. 

• Additional fields support cartridge tape, job scheduling and all other features of release G.01 .00. 

Many chapters reflect these changes. 

We hope you will find this edition informative. Your comments and suggestions are welcome via the 
"Reader Comment Sheet" at the back of this manual. 
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CHAPTER 1 IIENORY LAYOUT 



Fixed Lou nenorv (Series 44/48/64/68) 
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CSTB (BBSE OF CST TABLE)** 
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10 


11 


KCSTB (POINTER TO CURRENT EXECUTING 
PR0GRM1 BUCK) 


11 


21 


DSTB (BBSE OF OST TRBLE)" 
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31 





|3 
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CPCB (CURRENT PCB INDEX )** 
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111 
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Fixed Lou lltnorv (Series 44/48/64/68) (Cont, ) 

25| TR (TINE SINCE LAST SOFT TIBER INTERRUPT)** 1 21 

26| SCST (SVSTEH CLOCK STATUS)** |22 



27| 
30-37I 



SCLC (SVSTEH CLOCK LAST COUNT)** 



I23 
124-31 



NOTE: All pointers are absolute addresses. 

LEGEND: ** Needed by Fimuare and/or by Systen, always 

* Needed during INITIAL 

♦ Needed by nPE, set up by INITIAL or PROGENITOR. 
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Svsten Global Area 
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Systen Global Area fCont. ) 
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30 
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DFC 


33 


DISPLACEHENT TO SHBRABLE = «CST(U)STHDST(0) 


DFS 


34 


Snon Index 




35 


ABS ADDRESS (SYSDIT(S)) 


DIT8 


36 


Reserved 


SBANK 


37 


ABS ADR OF PHBC TABLE FOR LST/STT CHECKING 


SBASE 


40 


RESERVED FOR INITIAL (VDSENTRY) 




41 


RESERVED FOR INITIAL (VDSNAP) 
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SRTTRB BASE 
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43 
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SPECQHEAD 
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NBANKS 


50 


SCHEDULER TO AUAKE NESSAGE 


SCHEDTOAUAKEnSG 


51 


POINTER TO CSTBLK TABLE 


CSTXBLCKPOINTER 


52 


AUAKE TO SCHEDULER HESSAGE 


AUAKETOSCNEDNSG 


53 


UAIT TO SCHEDULER NESSAGE 
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CURACTPRI 
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Systen Mobil Area (Cunt.) 



/55I 
I I- 
1561 
I I- 
IS7| 
I I- 
1601 
I I- 
1611 



BUSY TABLE POINTER 

HERD TABLE POINTER 

TAIL TRBLE POINTER 

• OF SIO PROGRABS EXECUTING 

PARITY ERROR FLAG (BEB PE) 



1621 Inpeded Queue head for nessage buffer (PIN) 
I I — - 

J63I I/O Bessage systen error flags 

(0:1) - No SYSBUF avail for I/O error logging 



I I- 
KSEHVED 1 64 1 
FOR I/O < |- 
SYSTEB |65l 
I I- 
|66| 
I I- 
|67| 
I I 
1701 
I I- 
1711 
I I- 
1721 
I I- 
1731 
I I- 
\74| 



I (1:1) - No SYSBUF for IOBESSAGE (GENBSG) 



« OF TERHINBLS READING 



Nenory Layout 



BUSY 

HERO 

TAIL 

SIOCOUNT 

PARITY 

IONSGPIN 

IOLOGOX 



* OF TERBINALS URITING 
OSET B 



IRDCOUNT 
-I 

IURTCOUNT 
-I 

ICRIO 



-I 



LAST TWER 
HIGHEST ORT HUBBER 



RESERVED |10O 
FOR FILE< 
SYSTEB |101 
I 



POUERFAIL 

SYSTEI1 UP FLAG 

SYS CONSOLE LOGICAL DEVICE NUBBER 

COLD LOAO COUNT 



SHARED FCB DST 
NONITGRING FLAGS 



MX » OF SPOOL SECTORS 



CRIO 

CRIO 

HSYSDRT 

POUERFAIL 

SYSUP 

CONSLDEV 

CLOHOIO 

SHFCBOST 
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Systen Global Area (Cont.) 
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1 

1103 


CURRENT * OF SPOOL KILOSECTORS 


NUHSSEC1 


\104 


It SECTOR/SPOOLFILE EXTENT 


EXTSSEC1 


106 


BAX CODE SEGAENT SIZE 




106 


I1AX * OF CODE SEGI1ENTS/PR0CESS 




107 


llftX STACK SIZE (BAXOATA) 




110 


DEFAULT STACK SIZE 




111 


BAX EXTRA DATA SEGIIENT SIZE 




112 


BAX « EXTRA DATA SEGHENTS/PROCESS 




113 


DST nunber for BESSAGE buffers 




114 


UPDATE LEVEL 


UPDATEL 


115 


FIX LEVEL 


FIXL 


116 


VERSION LEVEL 


VERSION 


117 


DEFAULT CPU TIME UNIT 




120 


* OF SECONDS TO LOGON 




121 


JOBSYNCH BITS (13:3) 




122 


EXTERNAL PLABEL OF INITIATE 




123 


INTERNAL PLABEL OF INITIATE 




124 


BAXSYSDST 




125 


HAXSYSCST 




126 


Ldcv for SL.PUB.SYS I HOOA for SL.PUB.SYS 




127 


LODA for SL.PUB.SYS 




130 
131 


(DIRECTORY) 

(DISC ADDRESS) 
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Systen Global Area (Cont.) 
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1501 
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1511 
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1521 

! 
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1551 

I 
1561 



1 

SPOOUNDEX j 


EXT LABEL FOR SHGUCOfl | 


i 


CS IOUfill PLABEL | 


1 CS FIX LEVEL 


CS VERSION 


CCLOSE PLABEL 


LOGICAL PROCESS TABLE (PROGEH) 





i 


LOGICAL PROCESS TABLE (UCOP) 


21 


LOGICAL PROCESS TABLE (PFAIL) 


31 


LOGICAL PROCESS TABLE (DEVREC) 


41 


LOGICAL PROCESS TABLE (ORUSG) 


5| 


LOGICAL PROCESS TABLE (STI1SG) 


61 


LOGICAL PROCESS TABLE (LOG) 


7| 


LOGICAL PROCESS TRBLE (LOAO) 


SI 


LOGICAL PROCESS TABLE (IOBESSPROC) 


91 


LOGICAL PROCESS TABLE (SYSIOPRDC) 


10| 


LOGICAL PROCESS TABLE BEBLOGP 
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EXTERNAL PLABEL OF "TERnlNATE" 1 


INTERNAL PLABEL OF "TERBINRTE" ! 
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Systen Global Area (Cont.) 
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EXTERNAL PLABEL OF "COBBANDINTERP" 


INTERNAL PLABEL OF "COBBBNOINTERP" 


EXTERNAL PLABLE OF 


'SPOOUH" 


INTERNAL PLABLE OF 


"TRACEO" 


EXTERNAL PLABEL OF 


"TRflCEO" 


INTERNAL PLABEL OF 


•SPOOLIN" 


EXTERNAL PLABLE OF 


SPOOLOUT" 


INTERNAL PLABEL OF 


'SPOOLOUT" 
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2031 

I- 
204| 

I- 
2051 
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LOGGING 
BASK 

OSTN - BUFFER 
DSTN - BUFFER 1 
BUFFER LENGTH (SECTORS) 
FREE RREA POINTER 
FLAGK 

• RECORDS URITTEN IN BUFFER 

• RECORDS URITTEN IN BUFFER 1 
FILE SIZE (BLOCKS) - 1ST HALF 
FILE SIZE (BLOCKS) - 2ND HALF 

(LOG FILE SIZE) 

(BLOCKS) 
LOG FILE NUBBER (LOGFILENUH) 



STATE: 

EBPTY 

1 CUR 

2 FULL 



2061 NUMBER OF LOGGING [BLOCKS URITTEN (1ST HALF)] 
I 

2071 BLOCKS URITTEN [BLOCKS BRITTEN (2ND HALF)) 
I 
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Svsten Global Area (Cont.) 
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2111 



(TOTAL It LOG RECORDS MISSED) 



(DUE TO LOG FAILURE) 

JOB INITIATION" LOSS 



2121 TOTBL* RECORDS HISSED 

| 

21 3 1 TOTAL* RECORDS HISSED - "JOB TERMNATION" LOSS 
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2141 OPERATOR CONSOLE JOBSESSION « AT STARTUP 



2151 
2161 
2171 



RESERVED FOR KERNEL USE 



2»| HAPPING FIRHUBRE FLAG (NON-ZERO=HPE V/E UCOOE) 



221 | BANK AND ADDRESS OF HAPPING DST ( INITIALIZED 
222! BY DISPATCHER DURING LAUNCHING A PROCESS) 



2231 TOTAL SEGMENT NUIIBER OF CURREHT PROCESS 



224| 



I— • 



2251 

I 

2261 

I 
2271 

2471 
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253 1 
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HOLE LIST HEAD (BANK) 


HOLE LIST HEAD (ADDRESS) 


HOLE LIST TAIL (BANK) 
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Svsten Global Area (Cont.) 
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HEULETT-PACKARD DATA BASE (HPDB) 
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I- 

2741 



INDEX OF PCB AT HEAD OF DISPATCHING 
INDEX OF PCB AT TAIL OF DISPATCHING 
DST • OF CDT TABLE (DISC CACHING) 
BANK * OF THE CDT TABLE (DISC CACHING) 



2751 ADDRESS OF COT TABLE (DISC CACHING) 
| 

2761 HELP LOGICAL DEVICE NUMBER 

I 

277| CURRENT LOGON DST 

I 

3001 (STOP) 

3011 (BITS) (see p. 2-15) 

I 

302 1 # PROCESS ENTRIES 

I 

303 1 

| 



XDSCOUNT 
BUFFSIZE 
LDEV 
TLABEL 



GCLASSENABLED 

HEASSTATXDSBANK 

HEASSTSTXDSBASE 



SYSDISOHEAD 
SYSOISPQTAIL 
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Svsten Global Area (Cont. 



Svsten Global Rrea (Cont.) 
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TABLE 
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RESERVED 


Reserved 


DS GLOBAL DRTR SEGHENT DST NUflBER 


RESERVED FOR DS/3000 (SET TO ZERO) 


RESERVED FOR DS/3000 (SET TO ZERO) 


SDS 


JEV PLA8EL 




RESERVED FOR DS/3000 (SET TO ZERO) 


RESERVED FOR DS/3000 (SET TO ZERO) 


RESERVED FOR DS/3000 (SET TO ZERO) 


RESERVED FOR DS/3000 (SET TO ZERO) 


DISC STATUS 


LDEV 


1 


DISC 


flONESS 


flAXQUEUE 


DEFHULTQUEUE 



335 


DSCHECK P LABEL 


336 


DSOPEN PLABEL 


337 


DSC LOSE PLABEL 


340 


MANAGEURITE CONV. PLABEL 


341 


CONSDSLINE' PLABEL 


342 


CXREHOTE PLABEL 


343 


CXDSLINE PLABEL 


344 


CXRFfl PLABEL 



DSIHAGE PLABEL 

TAPE LBL AUTO REC FUN 



345 1 

I 

346 1 DEFAULT LABEL TYPE 

I - 

347| SYSDB PTR TO TERH INIT CHNL PGH (S30/33 ONLY) 
| 

350| HP| ISO 



3511 

I 

3521 



LAST CYCLE DURATION 



LAST 
DISC 
SIO 
ERROR 



JOBPRI 
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I CYCLE THRESHOLD 

3541 

I - 

3551 BUG CATCH ENABLE CELL 

I 

3561 MONITOR BUFFER I 

I 

3571 HONITOR BUFFER I 

I 

3601 DSBRERK PLABEL 

I 

361 t 8ank of last nenory uord 



TIHESTAHP 
TIHESTAHP 



362 1 Base of last nenory nortl 

/363I PVPROC PIH 

I I - ■ 

1 364 1 PV RECOGNITION COUNT 
PRIVATE< I ■ 

VOLUMES I365I VMOUNT FLAGS 
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IAUTOIALLI0N 



SOFTDEATH FLAG 
HEH PRESSURE 



MONBUFTO 
H0NBUFT1 



LAST HEHORY 
ADDRESS 



rienory Layout 



Systen Mobil Area (Cont.) 

I 

13661 

i I 

13671 

I 

\3»l 

I 

371 1 HSC CBTBLOG LOEV I 

3721 BESSBGE CBTBLOC DISC BOORESS 

I 

3731 HSC OST 

I 

374| COMSnPUNE' PLBBEL 

I 

3751 COHSIWJE PLBBEL 

I 

3761 SYSTEn LEVEL UDC FLAG (1 = SYS UDC'S EXIST) 

I 

3771 SYSDB RELATIVE POINTER TO SYSGLOB EXTENSION 

I 

4001 CPU NUHBER { Sit by softcfunp ) 

401 | WCROCODE nEBORY LOCUTIONS 
I I 

I | *NOTE THAT THE CONTENTS DEPEND ON THE TYPE 

I | OF CPU THAT PIPE IS RUNNING AND WHETHER fl 

I | DUHP, POUERFAIL, OR CNTL B/HflLT HAS OCCURRED 

4021 

The following locations refer all systens: 

X1401 = DUHPDEVDRT X1410 = S - BUNK 

02 = X 1411 = 2 

03 * OL 1412 = STATUS 

04 = DB - BANK 1413 - P6 - BANK 

05 = DB 1414 = PB 

6 = Q 1415 = P 

7 = SO 1416 = PL 

1417 = CIR 
1420 = High Bank 

The following locations refer exclusively to the Series 37: 

11421 = BICROCODE VERSION NUflBER 

BIT (0:2) 00 = BASTER RELEASED 

10 = PENDING RELEASE 

11 = EXPERIHENTAL 
BIT (2:6) BASE LEVEL (1-64) 
BIT (8:8) PATCH LEVEL (1-99) 

J1422 = FLAGS/MSC 

G.01.00 
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BIT (0:1) 1 If ON ICS 

BIT (1:1) 1 IF IN DISPATCHER 

BIT (2:1) LOC-ICBL/PHYSICflL 

1 IF LOGICAL 
BIT (3:1) 1 IF CHANNEL PROGRAn IS RUNNING 

BIT(4:1) SPLIT BANK FLAG 

1 IF SPLIT 
BIT(5:3) UNUSED 
BIT(8:8) LAST STOP CODE 

11423/7377 = CHANNEL PROGRfln AREA FOR BOOTING SOFTURRE 
(USED ONLY DURING BOOT). 

The following are assignnents after software has been loaded and launched: 

11540/1617 = Ron INPUT BUFFER FOR TERMNAL I/O 

1620/1677 = RDI1 OUTPUT BUFFER FOR TERMNAL I/O 

1700/1710 = Ron CONTROL BUFFER FOR TERHINAL I/O 

1711/1737 = Ron CONTRUL B INTERFACE BUFFERS 

The following assignnents refer to the Series 30/33/39/40/42/44/48/64/68: 

30/33/39/40/42/44/48 64/68 



11421 = SYSTEn HALT # 
142Z = ISR (INTERRUPT REGISTER) 

7.1515 = SYSTEH INTERRUPT BASK 

1516 = DRT 

1517 * DRT 1 

1520 « DRT 2 

1521 ■ DRT 3 



X1421 = CPX1 REGISTER 
1422 = CPX2 REGISTER 



Z151S = NIR REGISTER 



37/64/68 

1516 = DRT 

1517 = DRT 1 

1520 = DRT 2 

1521 = DRT 3 

1522 = DRT BANK 

1523 = DRT ADDRESS OFFSET 

1524 = INTERRUPT BASK FOR IHBO 

1525 = INTERRUPT BASK FOR II1B1 

1526 = INTERRUPT tlHSK FOR IMB2 

1527 = INTERRUPT nASK FOR IHB3 



All Systens: 

1740 = START OF SYSGL08 EXTENSION 
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SysGlob Extension 
Z200 words long; Pointer found at SyeOS + Z377 



SUBP QUEUE DELAY (*100flS) 



1 | BANK OF FIRST REGION IN LINKED nEBORY 
2 1 BASE OF FIRST REGION IN LINKED nEBORY 



31 GARBAGE COLLECTION ENABLE FLAG 
I - - 

4| HOVE THRESHOLD (IN PACES, FOR GARB COLL) 



miH nEnoRY page size (ih uords) 

VDS PAGE SIZE 



I LAST nAKE ROOB TIBE 
101 

I - 

111 HEBORY PRESSURE DURRTION THRESHOLD 
i 

121 NATIVE LANGUAGE TABLE (NLT) OST II 



131 RESERVED FOR NATIVE LANGUAGE SUPPORT 
! 

14| BAUD RATE OF THE SYSTEH CONSOLE 



/////////////////////////////////////////////// 



PLABEL FOR REBOTE'BPE 
PLA8EL FOR GETDS'NODENABE 



Henory Layout 



SUAPQDELAY 

FIRST 

BEBORY 
REGION 

GfiRBCOiLENfio 

HOVETHRESH 



Henory Layout 



631 



SysGlob Extension (Cont.) 

PLABEL RECLOG (INTERNAL) 
PLABEL RESTART (EXTERNAL) 
PLABEL RESTART (INTERNAL) 
PBBC LOU CORE BANK II (USER) 
PI18C LOU CORE ADDRESS (USER) 



121 HIOCNT 



651 

I- 
66| 

I- 
671 

I- 
701 

I- 
711 

I- 
721 

I 

73! PLBBEL 3270 (EXTERNAL) 

I 

74| VERSION 

I - 

751 UPDATE 

I 

76| FIX 

I 

77| COUNT OF TAPE CONTROLLERS USING nERSIO 



RESERVED FOR MAGE 
RESERVED FOR BEASIO 
LOROER CACHE SEGT1ENT HUHBER 



1001 PORT ORTA SEGBENT NUBBER 

I 

1011 RESERVED FOR SECOND PORT DRTR SEGBENT 
I 

1021 SYSTEH FPHAP OPTION FLAG 



571/////////////////////////////////////////////// 
I 

601 PLABEL USERLOG (EXTERNAL) 



61! 



62! 



PLABEL USERLOG (INTERNRL! 
PLABEL RECLOG (EXTERNAL! 



1031 
1041 
1051 
1061 
1071 
1101 

I- 
1111 

1171 



GLOBAL 

BLLOU 

BRSK 
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120! SYS POR' PROCESS PCB RELATIVE I*DEX 
I 

1211 GLOBAL AFT DST NUBBER 
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Svs&lob Extension (Cont.) 



1221 INITIAL/PROGEN COM. USED NUH8ER (Ch. 16) 
| 

1231 INITIAL SYSTEH STARTUP OPTION 

| - 

1211 PORT'IIBX'SER'COUNTER 

1251 

1271 CURRENTLY UNHSSIGNEO 

1301 (DS.NETUORK h&IIT.flPPLICATION SERVICES) 

1311 

1321 

1331 



1341 



I — 



1351 

I- 
136 1 



1371 



I — 



1401 

I- 
1411 



I — 



1431 



I — 



1441 
I- 

1451 



1461 

I- 
1471 



RESERVED FOR SPL 
PATH FLOU 
BNSLYZER 



1501 



CURRENTLY UNRSSIGNED 



2001 



memory Layout 
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JOBSYNCH job synchronization via jobsynch (sysglob*121(8)) 



(13:1) - JOBSREADY - set by DEVREC & ItOROUE (via procedure STRRTDEVICE) 
indicating a ready job. This prevents UCOP fron 
going to a wait state uhen a job is just nade 

ready. 

(15:1) - DEVFREED - set by DEALLOCATE uhen device count goes to 0. 



NOTE - Both bits above used for synchronization of job-nade-ready or 
devicefreed uhen UCOP is running. 

(14:1) - JOBSUAITING- set by UCOP just before uaiting if any job is 
uaiting for list device. Signals DEALLOCATE to 
auake UCOP uhen a device is freed. 
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• I1I0CNT = HERSIOCOUNT (3 BITS) 

■ BEASFLBGS (15:1) - 1 «> nOKITOR ENABLED 
(14:1) = 1 ==> BUFFER FLIP/FLOP 
(13:1) = 1 ==> EOT ON BONITOR TAPE 



System tables nay be accessed by using the LST/SST instructions. Pointers 
have the follouing format: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| | 

! Address I Bank 



-I 



Address is the uhole uord with "Bank" nasked out to 00000. 

Systems that have HPE V/E microcode (all 6X systems, 4X systems uith neu 
boards) can have a non-zero bank number. Systems running pre-WE V/E micro- 
code can only use hank 0, therefore the pointer uill look like: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I- 

I 



Address 



I 



ADDRESS 


NAflE 


08+55 


BUSY 


DB*56 


HEAD 


0B+S7 


TAIL 


DB*60 
DB*72 


SIO COUNT 
POUER FAIL 


DB*73 
DB*74 
DB+400 


SYSUP 
COHSLDEVN 
CPU NUI1BER 



Svs&lob Uord Definitions 
FUNCTION 

- SYSD8 relative pointer to BUSY TABLE for 
I/O resources 

- SYSDB relative pointer to table containing 
head pointers to I/O resource queues 

- SYSDB relative pointer to table containing 
head pointers to tail of I/O resource queues 

- Nunber of I/O Programs currently executing 

- 0-n© pouer fail 

1 -system disc recovery 
2-all other disc recovery 
3-all other device recovery 

- System is up and operable 

- System console logical device nunber 

- Set uhen systen aborts 
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Rllou flask Format 



The Rllou mask for nPE V is expanded to six uords. There is a mask in each 
user's JIT and in the SYS&L06 area. The Rllou mask contains enough bits for 
a one-to-one correspondence to every present OPERATOR type command, or any 
future OPERATOR connand. Uhen a user is RLLOUed any OPERATOR command or 
BSSOCIATEd to a device (uhich uill use OPERATOR type connands) then the cor- 
responding bit(s) in the mask in that user's JIT for that connand is set. If 
the RLLOU or ASSOCIATE uas done on a global scale, then the bit(s) in the 
mask of the SYSGLOB area is/are updated. 

The follouing EQUATES define the mask bit for each operator connand. 

The first set of commands define the operator connands dealing uith devices. 

Uhen adding a neu command to this set of EQUATES, be sure to add a cor- 
responding nove statement in L0GII1R&E, even if the connand uill not be 
logged. 

Uord Bit * 



ABDRTIO 













ACCEPT 





1 


1 




DOUN 





2 


2 




GIVE 





3 


3 




HEBDOFF 





4 


4 




HEBDON 





b 


b 




REFUSE 





6 


b 




REPLY 





/ 


/ 




STARTSPOOL 





8 


S 




TAKE 





9 


9 




UP 





10 


10 




UPLINE 





11 


11 




OSCOHTROL 





12 


12 




UPPER LIhTT->DEVICE COfldANDS 






ABORTJOB 





13 


13 




RLLOU 





14 


14 




9LTFILE 





15 


1b 




9LTJ0B 







16 




BREBKJOB 




1 


17 




DELETE 




2 


18 




DISALLOU 




3 


19 




JOBFENCE 




4 


20 




LWIT 




b 


21 




STOPSPOOL 




6 


22 




SUSPENOSPOOL 




7 


23 




OUTFENCE 




8 


24 




RECALL 




9 


2b 




RESUHEJOB 




10 


26 




RESUnESPOOL 




11 


■11 




STREAnS 




12 


28 




CONSOLE 




13 


29 
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Uin liatk (Com, ! 




Mora 


Hi 


1 


UARN 


1 


14 


30 


micm 


1 


15 


31 


ibn 


2 


C 


32 


MFF 


2 


1 


33 


VtlOUNT 


2 


2 


34 


UIOUNT 


t 


3 


36 


LMStOUNT 


2 


4 


36 


WUKWTROL 


2 


5 


3? 


JOBSEOIRITY 


2 


6 


38 


OWN LORD 


2 


7 


39 


MOENRBLE 


2 


8 


40 


niOOISBSli 


2 


9 


41 


LOO 


2 


10 


42 


FOREIGN 


2 


1! 


43 


ihf 


2 


12 


44 


SHOUcun 


2 


13 


4B 


OPEHQ 


2 


14 


46 


SHUTQ 


2 


15 


47 


MSCRPS 


3 


2 


48 






loaim Rtlattd Locations 



SVSD6 



1 2 3 4 5 6 7 J 9 10 11 12 13 14 15 



178 |..|..|..|..|..|..|. 

or ISTATEI 

173 



I--I--I--I--I--I--M--I--I 
DST « | 



STRTI • if retptctive bufftr tnpty 

1 if rttptctivt buffer it current 

2 if rttptctivt bufftr it full 



SYSOB 



am 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 16 

176 1 llllllllllll/lllllllllllll/tl/ll I SF I HF 1 6UF ISL I SO I 
I I 

SF • 1 if toft failure 
HF » 1 if hard failure 
BOF « if currtnt loa buffer it bufftr 
• 1 if currtnt log buffer it bufftr 1 
SI ■ 1 to indicatt a tuitch in log bufftr* (from to 1 or fron 1 to 0) 
SD > 1 to indicate thutdoun in progrtll 
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Initial Henorv Allocation 



This section is a description of the netbod used by INITIAL to allocate 
nenory for BPE tables and code segnents in HPE V/E. Rll nenory allocated by 
INITIAL is pernanently allocated. Rll non-core resident code and data is out 
on disc before exiting INITIAL. 

nt the nost basic level WHIRL uill try to build nenory to look tKactly as 
diagranned belou. There are, bouever, several uays in uhich to deviate fron 
this structure. Before going into the sources of these deviations, it is 
necessary to point out uhich portions of nenory art used by INITIAL during 
the restart and therefore cannot be used by !IPE until INITIAL has finished. 

Before INITIRL begins to allocate any nenory space, it relocates its core 
resident code, its code segnent snapping area and its stack to the highest 
configured nenory space. Additionally, it uses the last Z326 uords of bank 
on series 4x nactunes for its I/O buffer area and tenporary code segnent 
table. After INITIAL has built all of core resident NPE (tables and code), it 
builds the disc resident (1PE tables. Since sone of the disc resident tablet 
nay be too large to be built in INITIAL'S stack, these tables are built in 
unused nenory space. Therefore, in addition to the nenory space rewired for 
INITIAL s code, INITIAL'S stack and core resident WE, there nust be enough 
space left in uhich to build the largest of the disc resident tables. 

For Series 6x nachines uith the NPE V/E firnuare, INITIAL uill build the 
tables uith ">" signs by then out of Bank if necessary. For all other 
tables, INITIAL uill essentially build nenory in the order show belou. 
There nay be an unused fragnent of nenory betueen the DRT's and the systen 
global area uhich INITIAL uill fill uith the snaller tables. Neither the 
tables narked uith an asterisk nor the code segnents uill ever be put in this 
area. NOTE: INITIRL uill build all tables on 32-uonJ boundaries. 

If the systen being built by INITIRL is configured uith 128K uords or 160K 
uords of nenory then INITIRL's stack uill be in bank 1 (the code also on a 
128K uord nenory size). If INITIAL is occupying part of bank 1 and the space 
is needed for a core resident BPE code segnent or to build a disc resident 
table then INITIRL uill print the error message "ERROR »350 OUT OF BEMORV". 

™5??Ji for the ""P' 10 " 5 8tated Jb ove, for every allocation of nenory 
521: , flrs ' ,ry *° Jll0 " ,e "V renaming space betueen the ORT's and 
5Y5DB. It uill then try the next available space in bank 0, then the next 
available space in bank 1. If it uere necessary it could continue searching 
until all all banks uere checked for available space. 

Innediately before exiting INITIAL, INITIAL lays doun all the nenory region 
headers and trailers as shoun belou. For any one bank of nenory there uill 
only be one block of core resident NPE, regardless of its contents. The only 
block of core resident NPE that does not have a reserved region global header 
is in bank 0. It does have the reserved region global trailer though. Before 
placing any code outside bank the first 24 uords of every bank (except bank 
0) is reserved for the region global header. 
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PrKtli itOl Lilt Jjuagi Ltwut 



sysdb 

300 



STOP BITS REPRESENTING UHICH 
PROCESSES TO STOP ON "SHUTOOUN" 



» PROCESS ENTRIES 
'HlilWinMUliuihmnnuf^Mnttltl 



1ST PROCESS ENTRY 
2ND PROCESS ENTRY" 



317 I 
I- 



LAST PROCESS ENTRY 



Entry Fomat 

1 2 3 4 5 6 7 I 9 10 11 12 13 14 15 



I--I--I--I--I--I--I--I--IH--I--I--I- 



PROCESS PIN • 



STOP BIT * 



PROCESS URIT STATE 



Prtattiontd Entritt 

tntry # process 



ttop bit • 



dtvrec 


2 


ucop 





log 


1 
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Bank 
Lou Core nenory 



>DRT 



Systen Global area 



Firnuare area 
SYSGLOB Extension 
OST/CST/CSTK 
ICS 



PtIBC 



ILT/DIT 

OLT 

Resource Tables 



CST Block 
>Henory Neaturenent Info 

VDSII Table 
Job Process Count 



(Only on 64/68 if Pri- 
vilege (lode Bounds 
Checking is enabled. ) 



(Only for 64/68 if Pri- 
vilege Node Bounds 
Checking is enabled.) 



> PRI/SEC ttSR 



>PCB 



I- 



> Suap Table (SLL) 



I 'Special Request Table 



>Job Cutoff Table 

>Tirter Request List 

>Systen Buffers 

>LP0T 

>M0 

>SIR 

>N0N Table 



0.01.00 
1- 24 



nenory Layout 



BankO(Cont,i 



Core Resident CST's in CST order 



Reserved Region Global Trailer 
Available Region Global Header 



Available flenory 



Available Region Global Trailer 



NOTE; The > Means these tablet can nove out of Bank if necessary. 
Bank 1 
Reserved Region Global Header 



Core Resident CST's and 

tables narked uith ">" that 

didn't fit in BANK 



Reserved Region Global Trailer 
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CHAPTER 2 nEnOBV BRNflGEBEHT TABLES 



Sequent Table Structure 



The current location and state of each data segnent and loaded code segnent 
is naintained in the Segnent Table. This table is partitioned into three 
separate tables as shoun in Figure 2-1. The partitions an based on the seg- 
nent classes: a segnent is a data segnent, a segnent is a systen SI segnent, 
or a segnent is part oF a program The structure and fomat of each parti- 
tion is described in the following. 



(Z2),(X1002)*SYSBASE ■ 



(zo), (11001 )+SYsensE ■ 



cstxbap 



-> I 



(Z1051) — >| 



* ♦ I 

I I I 
* ♦ I 

I I — * + 

+ + I 

I I I 

I ! I 

I I I 

+ 4, j 

I | * 



I LORDED 

I prawn 



First 
I LOADED 
IPROGRAB 



->, K - (Z3), CURRENT PRDERfiil POINTER 

I NEXT 



Overall ST Structure 
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Pointers and DST fl's of Segnent Table Conponents 

i. DST 

Z 2 absolute address of entry of the DST. 
Z1002 sysbase relative index of entry of DST. 
DST nunber 2 is the DST Table dst <t. 



I absolute address of entry of Systen SL. 

11001 sysbase relative index of entry of Systen SL. 

Z1032 displacenent fron OST base of entry of Systen SL (i.e. 

ecsT(iast) - eosT(o) = dfs ). 

DST nunber 4 is the CSTX Table DST ft. 



Z 1 absolute address of entry of current progran. 
Z1033 displacenent fron OST base to first CSTX entry SL. 
DST nunber 4 is the CSTX Table DST *. 



iv. CSTXBBP 



Z1051 sysbase relative index of entry of CSTXHAP. 
DST nunber 43 (Z72) is CSTXBflP Table DST #. 
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Benory Banagenent 



Standard Object Identifier Fomat 

1 2 3 4 S S 7 8 9 10 11 12 13 14 15 
TYPE I CSTBLK 

OBJECT NUNBER 



DST General Entry Fomat 
Case (i) DST Entry for a Present Data Segnent 



0BJIDENTIFIER(0).(0:4) «> TYPE 

= Object is a Data segnent 
= 1 Object is an SL segnent 
= 2 Object is a Progran segnent 
= 3 Object is a Cache Donain 

0BJIDENTIFIER(0).(4:12) ==> Progran index into CSTXBLK 
0BJIDENTIFIER(1).(0:16) «> Nunber field: 

DST, CST, CSTX, or CDT nunber 



DST Entry Fomats 
DST/CST Entry Fomat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

UORD 01 * CONFIGURED ENTRIES 

i - 

UORO 1| ENTRY LENGTH (4) 

I 

UORD 2| It AVAILABLE ENTRIES 

I 

UORD 3 1 TABLE RELATIVE INDEX TO FIRST FREE ENTRY 
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UORD 
UORD 1 



UORD 2 
UORD 3 



12 3 4 
-l-l-l-l-l- 
A 10 |R I 



7 8 9 10 11 12 13 14 15 
-l-l-l-l-l-l-l-l- 
SIZE/4 



D |R |I IS |B IF |S IC |U| 

C |0 |B |T |0 |U IV |0 IDI VKBLLDC 

V |C |I |K ID |I IS |R | I 

I I I I IP I IE I I 



BANK 
BRSE 



FIRMINFO 

FLAGS 



BBBANK 
I1I18ASE 



Case (ii) DST Entry for an Absent Data Segnent 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

FIRBINFO 



UORD 2 
UORD 3 



l-l-l-l-h-l-l-l-l-l-l-l-l-l-l"l-l 

|A 10 |R I SIZE/4 | 


ID |R |I IS |(1 IF IS |C |U| 
IC 10 IB IT ID IU IY 10 IDI 

iv |c Ii Ik id Ii Is |r I i 

I I I I I IP I IE I I 


fflALLOC i 


i L0EV H | 


HODA | 


I LODA I 



HOOA 
LOOfl 
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Ntnory rtinagtntnt 



C1T inni ftnuw 

CST Gtntrtl tntry Pernat 

Gate (1) CST Entry far * Prtttnt SI Stgntnt or CST* Stgntnt 



UORO S 
MUD 1 



MRD 2 
WRO 3 



12 
*"|n"|« "I 



3 4 

rl-" 



S 6 7 



•l-l-l 



1 9 10 11 12 13 14 1! 

M.--M--I--I--I--1 



SI2E/4 



/ 1* il 1/ 1/ 


1 


/ id in 1/ 1/ 


I 


/ ic i: i/ i/ 


f 


/ ! 1 \l\l 


/ 



I FIIWNFO 
-I 



s ic i inn iiitiun iiiin i 
v lo Miiimmmmmm i flags 
s m uimiimmmmm i 
ii umiiiiimiiimmi i 

BANK | M8BNK 

SUE I MISUSE 

— I 



CflSe (ii) CST Entry For fin Absent Stgntnt SL or CSTK Stgntnt 



UOSD 
UORO 1 



IBRD 2 

mm 3 



1 2 3 4 S 6 ? 
-I-I-I-I-I-I-I-I 

t IB |R IT I 



S 9 10 11 12 13 14 IS 
-l-l-l-l-l-l-l-l 
SI2E/4 | FIAIUNFO 



« ii 1/ 1/ 1/ is ic i miiiiiiiimimm i 
o in 1/ i/ i i\i io \mmiimimimm i flags 
c ii i/ 1/ 1/ is ik Mimmmmmimi i 
i i/ 1/ 1/ 1 ie Mimimmmimm i 
- ——i 

LOW * | HCOB | HOOA 



1MB 


Cmi (iii) OST/CST Frte Entry 


X100000 


TABLE RELATIVE OFFSET TO NEXT FREE ENTRY 



-I 



LODfl 



TABLE RELATIVE OFFSET TO PREVIOUS FREE EHTRV 



iiiiiiimimmmmiimmimiiiiiimn 



-i 

lltftr to tht Logical Segnent Tablt Fornat in Chapter 11 for nort 
information on XCST. 
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ST Entry Filid tuerntiom 



A ■ 1 «■> ttgntnt ibitnt 

tl • 1 »■> ttgntnt priviltgtd 

I ' 1 «i ttgntnt hit Own rtftrtnetd 

T ■ 1 »•> ttgntnt it Btwg trtctd 
DCV • 1 •■> disc copy it valid 
STK > 1 •■> Migrant it i stack 

rfflO ■ 1 »•> t ttgntnt nodification (tip., contr.) il Binding 
Fuip. 1 ••> t forced uritt of thit ttgntnt it in progrttt 
VtlPAGECNT ■ t of virtual ntnory pagtt ailocattd to thit ttgntnt 
ROC • 1 ••> ttgntnt it rtcovtrablt ovtriay candidttt 
Ihl * 1 ••> ttgntnt it in notion in 
SVS ■ 1 ••> ttgntnt it a tytttn ttgntnt 
CORE* 1 •■> ttgntnt it con midtnt 
UD- 1 ■■> uritt disabled 



atatOiaiM 

CSTBLK(O) 



* NUMBER OF EKTRIES IN TABU 

1 

* ANY UHASS1GNCD ENTRY ■ -1 

2 

* ANY ASSIGNED ENTRY > 

3 

< RENAINMG CSTBLK TAIL! ENTRIES 



Tht tablt it initialind to ninut ont in tach tntry, Uhtn ttltcttd, tht 
tntry it replaced by a DST-relativt indtx to tht tntry NO of tht CST txten- 
tion block. Thit it the tht ovtrhead tntry for tht attociattd progran. 
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Progran Blocks and the CSTXnfiP 

Since prograns can be dynanicaily loaded and unloaded, the segnent table nust 
be kept packed or fragnentation would occur. Thus, the block of ST entries 
for a progran segnent begins at an ST entry nunber that changes if a progran 
which was loaded before it gets unloaded. To Manage this dynanic structure, 
an auxiliary structure, the CSTXHRP is used. A progran is identified by its 
index, CSTXEIX, into this nap. The progran's current beginning physical ST 
entry nunber is equal to equal to CSTIMP (CSTXEIX). 

Entry Fornat - CST Extension Block 

CSTXITAP(CSTX£IX)-->-- 

* II - N OF CST'S IN BLOCK » 

1 « VAUDITY=Z125252 » 

2 * It OF USERS SHARING BLOCK • 

3 * * 

XCST NON-XCST 

1 > * HAS CST ENTRY FORriRT « < X301 

2 > * HAS CST ENTRY FORNAT « < Z302 

«t1 — > * HAS CST ENTRY FORNAT * < — X303 



The value of CSTXEIX is established uhen a CST extension block is allocated. 
This index into the array CSTXI1AP is Maintained in the PCB of each process 
sharing the block. 



Nenory Nanagenent 



OCTAL 

1 
2 
3 
4 
6 
6 
7 

10 

11 

12 

13 
14 
15 



Fixed OST Entry Assignments 



DECII1HL 



CST 
OST 
PCB 

CSTX 



PROCESS-PROCESS I 10 

COHHUNICATION TABLE I 



SYSTEN GLOBAL AREA I 



CORE 
ICS 
SYSTEN BUFFERS 



-I 

UCOP REQUEST QUEUE | 
-I 



I/O QUEUE 
TERNINAL BUFFERS 



I 11 
-I 

I 12 



LOGICAL-PHYSICAL | 13 

DEVICE TABLE 



LOGICAL DEVICE 
TABU 



I 14 
I 



-I 



DRIVER LINKAGE TABLE I 15 



-I 

I/O RESOURCE TABLES I 16 
I 

SECONDARY dSG TABLE I 17 



LOADER SEGNENT TABLE I 18 

■ I 

TIBER REQUEST LIST | 19 
■ I 

DIRECTORY I 20 



CST 

OST 

PCS 

CSTX 

SYS 

CORE 

ICS 

SBUF 

UCRQ 

ppcon 

IOQ 
TBUF 

LPOT 

LOT 

DLT 

BUSY, HEAD, TAIL 

SECHSGTRB 

LST 

TRL 
DBS 
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DST (Cent.) 
OCTAL 



DIRECTORY SPACE 



-I 



RIN TABLE 
SUAPTABLE (SLL) 



21 
I 

I 22 
I 
I 23 



JOB PROCESS COUNT I 21 
j 1 

31 I JOB HASTER TABLE I 25 
| 1 

32 I TAPE LABEL I 26 
I TABLE 



I- 
33 I 



LOC- TABLE 



34 I REPLY INFORHATION 
I TABLE 



3S | VOLOTIE TABLE 



I- 
36 | BREAKPOINT TABLE 



I- 



37 | LOG BUFFER1 



40 
41 
42 
43 

44 



LOG BUFFER2 
LOG ID TABLE 
ASSOCIATE TABLE 

CST BLOCK 



JOB CUTOFF TABLE 



I- 



45 I SYSTSt JIT 

I - 

46 I SPECIAL REQ TABLE 

| 

47 | VIRTUAL DISC SPACE 
| HANAGEHENT TABLE 

I — 

50 I DEVICE CLASS TABLE 

| 

51 I Reserved Kernel 

I 



27 
21 

29 
30 
31 
32 

33 
34 
35 
36 
37 
38 
39 

40 
41 



TABLE HAHE 

RIN 

SUAPTAB 

JPCNT 

jnBT 

VOD 
LOGTAB 

RIT 

VTAB 

STOP 



UDTAB 

CSTBLK 

JCUT 
SJIT 
SRT 

VOSHTAB 
OEVCLASS 
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Suae Tables 



The SUAPTAB is a core resident nenory nanagenent table used to keep track cf 
the locality lists of the conpeting processes. The PCB entry for a process 
has a SUAPTAB relative pointer to the header entry for the process. 

SUAPTAB DST* = 23 (Z27) 

11004 Systen table pointer to SUAPTAB entry 0. 

NOTE: The nunber of entries configured Hill be 3 
greater than the nunber configured via 
SYSDUE1P. (Entry consunes 3 entries). 

SUAPTAB Entry Fornat 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 




1 
2 
3 

5 
6 
7 

8 
9 
10 
11 
12 



* ENTRIES CONFIGURED 
ENTRY SIZE (6) 



* AVAILABLE ENTRIES 



TABLE RELATIVE INDEX OF FIRST FREE ENTRY 
TABLE RELATIVE INDEX OF LAST FREE ENTRY 



HIGH UATER nARK 
• PRMARY ENTRIES (0) 



HEAD OF MPEDED QUEUE (PCB RELATIVE) 
TAIL OF MPEDED QUEUE (PCB RELATIVE) 



B CURRENTLY MPEDED PROCESSES 
HAX « OF INPEDED PROCESSES 
CUnULBTIVE « OF MPEDED PROCESSES 





1 
2 

3 
4 
5 
6 

7 

10 
11 



I 21 
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DST (Cont.) 
OCTAL 


DECIHRL 
42 

43 
44 
45 
46 
47 
48 
49 
50 

51 
52 

53 
54 
55 
56 
57 
58 
59 
60 


TABLE NAflE 


52 


ILT 


ILT 


53 


SIR TABLE 


SIR 


54 
55 


FIWVT 

INPUT DEVICE DIRECT 


FI1HVT 

IDD 


56 


OUTPUT DEVICE DIRECT 


ODD 


5? 


UELCOW HESSAGE #1 


LOG0NDSTN1 


60 


UELCOHE nESSBGE *2 


L0C-0NDSTN2 


61 


CS DATA SEGHF.NT 


CSTAB 


62 


PROCESS-JOB 
CROSS REFERENCE 


PJXREF 


63 


SYSTEn JDT 


SYSJDT 


64 


COnnAND LOGON DST 


CILOGDST 


65 


nOUNTED VOL. SET TABLE 


nVTAB 


66 


PRI.VOL. USER TABLE 


PVUSF.R 


67 


RESERVED KERNEL 




70 


DISC REQUEST TABLE 


DISCREQTAB 


71 


nSG HARBOR TABLE 


nSGHARBTAB 


72 


PRMARY HESSAGE TABLE 


PRMtlSGTAB 


73 


NEASUREHENT INFO TABLE 


HEASINFOTAB 


74 


FIRST FREE DST 





G.01.00 
2- 10 



G.01.00 
2- 11 



Nenory nanagenent 

SUAPTAB Unassiqned Entry Fornat 

0123466789 10 11 12 13 14 16 


1 
2 
3 
4 
5 



An assigned entry in the suaptab is a process' SLL header or a nenber of a 
process' SLL. These fomats are nou described. 



| X100000 


! TABLE RELATIVE INDEX OF NEXT FREE ENTRY 


! TABLE RELATIVE INDEX OF PREV. 


FREE ENTRY 


! o 


! o 


! 

I 1 
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Seanent Locality Litta (SLL) 

Tha tyittn ntintaine for itch proem a eegnent locality liat (SLL) of thi 

tegnente belonging to that proem' currant uorking nt. The proem' SLL 

conaittt of a header and a liat of entries. The haadar and liat antriaa ara 
taken f ran tha SMAP TR8, 

A proeaaa' SLL ia loeatid via tha procaaa' PCB antry. PCB01 contains tha SLL 
ralativa index of tha proetaa' SLL haadar. 



SWPTBB 



PCB01- 



I 

+-> 

+-- 



SLIHERDER 



FIRST SLL ENTRY 



NEXT SLL ENTRY 



0.01.00 
2- 13 



SLL Litt Entry Fount 



1 2 3 4 S ( 7 8 9 10 11 12 13 14 15 



■I--I--I-I-I-I--I-I-I--I-I-I- 
| PCB RELATIVE INDEX OF THE NEXT IBPEDED PIN 



I- 



1 I TABLE RELATIVE INDEX TO NEXT ENTRY IN UST 



TABLE RELATIVE INDEX TO PREV. ENTRY IN UST 
OBJECT IDENTIFIER 



IS ID |L IB 


F IS 


IT II 10 IL 


R IL 


IX IS |C |K 


IL 


I IC |K |R 


Z II 


I II IE IE 


e in 


I 10 ID |0 


N II I 



T IF |L ID I 

|Z IK IE I 

S |R IR IC | 

S IE IE |C | 

IS ID IX I 

I I IT I 



PRE 

FETCH 

COUNT 



Btnory hanaganant 



NEXTlnPPIN 

NEXTIKX 

PREVINX 

SLL'OBJDESC 

SLL'OBJNUn 

SLL' FLAGS 



SLL(SLUNX*0) NEXTIBPPIH, next nake present deferred queue 
PCB Index 

SLL(SILINXH) NEXTINX, next SLL entry 

SLL(SLLINX»2) PREVINX, previous SLL entry 

SLL(SLLINXt3) SLL'OBJOESC, 1st uord of object identifier 

SLL(SLLINX*4) SLL'OBJNOB, 2nd uord of object identifier 



SLL(SLUNX»5) 



.(0:1) BAPSEG, process' CST napping segment (LSTT) 

.(1:1) STK, process' stack entry 

.(2:1) DISCIOSEG, disc I/O pending on this segnent 

.(3:1) LOCKED, segnent locked in nenory 

.(4:1) BLKLK, request for blocked lock 

.(5:1) FROZE, eegnent fro2en in nenory 

.(6:1) SLUM, process queued for this segnent 

.(7:1) TOSS, Toss this entry 

.(8:1) FRZREQ, request segnent to be frozen 

.(9:1) LKREQ, request to lock segnent in nenory 

.(10:1) OECCNTFLAG, 

.(11:5) PREFETCHCOtlNT, 



The Suip Table uill be configured uith at least tuice the 
n'/nber Of rnnfiflyroH prne. 



Nenory nanagentnt 
SLL haadar Fernet 



1 2 3 4 5 6 7 J 9 10 11 12 13 14 15 



S IN II IP 


s 


s 


U |A IN |A 


T 


u 


A IS IT IR 


R 


I 


e in ii t 


T 


p 


9 IE 10 I 







in ic In v 





-I--I--I--I--IH--I--I- 



I IOCNT 



TABLE RELATIVE INDEX OF FIRST ENTRY IN LIST 



mtiiiiiiiiiiiiiiiiiiiiiimiiiiitiiiiiiiiiiii 



TABLE RELATIVE INDEX Of IttlWRY REQUEST ENTRY 



• ENTRIES IN PROCESS' SLL 



lllillllllllltlllllllltlltllllltlllllllllllllll 



SCHEOTOIOMG 



REflREQINK 
SECCOUNT 



SLL(SLLHEADINX«0) 

.(1:1) SUREO, Suap Required Flag 

.(2:1) HASBEB, Has Btnory Flag 

.(3:1) INTLOC, Initialize locality to nininun 

.(4:1) PRRTIN, Process partially euapped in 

.(5:1) STRTOV, Start suap over flag 

.(6:1) SUIP, Suap In Progress Flag 

.(8:8) IOCNT, Segnent read conpletions until auake 
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Special Request Table 



Used for pasting data eegnent size change info and for keeping 
a liat of devices waiting for a ttgntnt to arrive in nenory. 

11042 - SRT relative index to entry » 

Z1043 - SRT relative index to tht htad of the queue 

NOTE: Tha nunber of entries configured will be 3 greater 
than the nunber configured via SYSOUflP. (Entry NO 
consunes 3 entries). 



SRT Entry Format 



| « ENTRIES CONFIGURED 



I- 



1 I ENTRY SIZE (6) 

| 

2 I « AVAILABLE ENTRIES 



3 | TABLE REL. INDEX OF 1ST FREE ENTRY 



A ITRBLE REL. INDEX OF LUST FREE ENTRY 
5 | HIGH LATER BARK 



6 

7 
8 
9 

10 
11 
12 

" ! 



« PRinARY ENTRIES 



HEAD OF IBPEDEO OUEUE (PCB REL.) 
TAIL OF IBPEDEO OUEUE (PCB REL.) 



* CURRENTLY IBPEDEO PROCESSES 

• BRXIBUB IBPEDEO PROCESSES 
CUBULRTIVE • OF IBPEDEO PROCESSES 
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The follouing entry fomat is For data segnent size changes: 



NEXT ENTRY FOR DATA SEWENTS 



OBJECT IDENTIFIER 
NEU DRTR SEGflENT SIZE 



READ DISPLACEI1ENT 
NOVE COUNT 



-I 



The follouing is the fomat for devices waiting on a segnent: (The region 
header for the segnent contains an SRT relative index to this entry. If nore 
that 5 devices an uaiting on this segnent, another entry uill be linked to 
this entry.) 



I- 



1 

NEXT ENTRY OF OUEUEO DEVS ON SEG I 



IOQINX 

ioqinx 



IOOINX 



iooinx 



The nunfaer of prinary configured entries uill be equal 
to the total nuitber of LOEVs configured. The nunber of 
secondary entries uill be configured to be at least the 
sane as the nunber of PCBs configured. Data segnent change 
entries are secondary type, uhile devices queued entries 
will be prinary entries. 



G.01.00 
2- 17 



(lenory tlanagenent 



Rain fienorv Region Headers and Trailers 



Rain nenory is partitioned into regions. Each region is in one of four 
states: available, reserved, assigned, or cached. 

Rn available region is available for consunption by the free space allocation 
nechanisn. Rn available region consists of neighboring subregions, each of 
which is either a hole or an overlay candidate. Rn available region is 
linked into the available region list. 

R reserved region is a nain nenory region uhich is in the transition state 
fron available to assigned. R reserved region has been cleaned, and there is 
a pending disc read of a segnent into the region. 

Assigned regions are occupied by present segnents. Available and reserved 
regions consist of one or nore adjacent subregions. Region headers and 
trailers are partitioned into global and local conponents. The global region 
header/trailer is only valid for the first/last subregion in regions consist- 
ing of nore than one subregion. 

The region headers and trailers of available, reserved, and assigned regions 
contain the state and control infomation pertaining to the current or plan- 
ned contents of the region. 

Cache donains ars another fom of assigned regions and are designated as such 
in the subregion header. If the cache donain is "napped" (I/O pending 
against it) then the object identifier uill have a non-zero value in the 
second word of the segnent identifier field. If the second uord of the seg- 
nent identifier field is zero, then this region is a cache donain that is un- 
napped. (Refer to Chapter 23 for further infomation regarding Disc 
Caching.) 
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Header length = 24 
Trailer length = 4 



Global Region Trailer 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 

RB-28 I NOT USED I 



I-27 | 
I- 



PREVIOUS TRAILER SUBREGION SIZE 



I PTSS 



RB-26 PREVIOUS TRAILER REGION STATE I PTRHS 

fi |R ID I llllllllllllllllllllllllilllllllllllll I 

S IE |V \l!lltlllllllllllllltllltllllllllllllll\ 

S IS I I//////////////////////////////////////I 

I 1 

RB-25 I PREVIOUS TRAILER REGION SIZE I PTRS 

I 1 



Global Region Header (Available Regions) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|-|..|..|.-|-|-|..|-|..|-.|..|-|-|-|-|-| 
RB-24 | REGION ASSIGNMENT STRTE I RRS 



IB-23 I 
I- 



|B |R |R |C IS IL |F II |l |///////////////// 

IS IE IV |L |: IK |Z 10 IS Vllllllllllllllll 

IS IS I IN | IP IN IF IT Ullltlllllllillll 

i i i id i i i iz it \i i ii ii minimi 

i i i i i i i in i Miimmmmii 
i- 



REGION SIZE 



I RS 



i-22 Miiiiiiimmimiiiiiiimiiiiimmiiiiiiin 
i i 

i-2i i miiimimimiimiimiiiiiiiimiiimm i 
i 1 

1-20 | PREVIOUS LINK (ADDRESS OF PL FIELD I 

I- -I 
I OF PREVIOUS AVAILABLE REGION) I 

I - - - I 

1-18 I NEXT LINK (ADDRESS OF NL FIELD) 

| IN NEXT AVAILABLE REGION) 



I NL 



rb-16 Miimmimmimiimmmmmmmiin 
i - i 
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Subregion Header (Available Regions) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
RB-15 | SUBREGION RSSIGNHENT STRTE I SRS 

ic ir ir \mmmiiimmiiimiiiii\ i i 
is ie io \mmmimmmiiiiimii\ o i 
ic if ic Miimmmmmmtmmn s i 
ih i i uiimmtmmmiimmm t i 
i - — i 

RB-14 | SUBREGION SIZE I SS 

I " I 

RB-13 |V | SUBREGION OISPLACEBENT IN NAIN HEM. PAGES I SD 
I I 

RB-12 | URITE REQUEST POINTER I UREOP 

| 1 

RB-11 | I OBJIOENT 

I- OBJECT IDENTIFIER -I 
I I 

I 1 

rb-9 i iimmmmmmiiiimmiiiiiimmimi i 
i — i 

rb-8 \imiiiimmitimimiiiiimimmiiimin 
i - i 

RB-7 | LOEV | HODR I HODR 

I - I 

KU-6 | Lou Order Disk Address I LODA 

| | 

rb-5 \mmmmmmmimmimimimiimii\ 

i - — i 

rb-4 i miimiiiimmimmmmmmmiiiiiii i 

i - - i 

rb-3 i mmmmiimiimmiiimiiimiiiiiiiiii i 

i 1 

rb-2 i immmimmmiimimiimmiimiim i 

i - i 

rb-1 i iiiiiiiiiiiiiiiimmmiiiimiiimmmm i 

i — 1 
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Hrtti Fnitn Htimr ("instil Suuiaj 



1 Z 1 4 6 6 7 t 9 10 11 1! 13 14 16 



R8-24 



RB-U 
M-17 
S8-16 



|~|--|--l--l--l--l--l--l--l--l--l--l--l--l- 



REGION SSSI0N11ENT STATE 



|L IF 

IK IZ 

IP IN 

I I 

I I 



i a Miiiiiiiiiiiiium 

I! I/////////////////II 
F IT I/////////////////IP 

1 IT I/////////////////I 
N I Mllllllllllllllll\ 



REGION SIZE 
ON DOING I/O COUNT 



| RS 
IOCNT 



INITIATION flESSfl&E 



10 II IE |0 
N |U IN |N |n 
G IE |C IP IN 
D IS 10 IN IB 

1 IE IN IE IN 
IS N |G in 10 10 
|H G |R IS IU IE 

IE |V IE | 

IE I I 



I I 



in \IIIII1IIIIIIIIW 

IS I//////////////IS 

IG I//////7///////IG 

IS I//////////////IV 

IT I//////////////IA 

IB I llllllllllllll I L 

IR I//////////////II 

IT I//////////////ID 

' Mil I II I III III t\ 



LOCATION OF DISC REQUEST OR nfJVE nSG 



OTIPLETION HESSAGE 

in le is II in l//////////////////////////|n 



l ic |o is (//////////////////////////is 

K IH IU |G I///////////////////////W/IG I 

o IE in in I//////////////////////////IV I 

L 10 II IB I//////////////////////////IA I 

k in it |o MUlllllllllllHllllllltllW I 

IS I IR \llllllllllllllllllllllllll\l I 

IG I IT (//////////////////////////ID I 



HAKE PRESENT DEFERRED QUEUE (PCS INDEX) 



RELEASE PftGE COUNT 



-I 

I nPQUNK 
-I 

I PAGECNT 



SPECIAL REQUEST TABLE PTR (SRT TABLE RED 
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hmmz Stmt iimsai "HUnH 



1 Z 3 4 S 6 7 t 5 10 11 IZ 13 14 15 



RB-1S 



RB-14 
RB-13 
RB-1Z 
RB-11 



-I--I--I--I--I--I- 



-I--I- 



SUBREGION ASSIONBENT STATE 
C IR IR Slllllllllltlllllllllllllllllin I 
" IE 10 \llllllllllllllllllllllllllllll\ 

c if ic \iiiiiitiiiiiiiiiiiiiiiiiiiiiu\ s 

H I I Mlllllllllllllllllllllllllllin T 



SUBREGION SIZE 



SUBREGION DISPLACEnENT IN MAIN NEN. PAGES 



URITE REQUEST POINTER 



I 



OBJECT IDENTIFIER 



I- 



LDEV 



I HIGH ORDER DISC ADDRESS 



RB-9 | FREEZE COUNT I LOCK COUNT 
I 

RB-3 I U8JTE DISABLE COUNT I I/O FROZEN COUNT 

RB-7 
RB-6 
RB-5 
RB-4 
RB-3 



LOU ORDER DISC ADDRESS 



Mllllllllllllllllllltllllllllllllllllllllllllll 



Mllllllllllllllllllllllllllllllllllllllllllllll 



I 



TinE OF 
MiRIVAL 



1-1 I lllllllllllllllllllllllllllllllllllllllllllllll 



I- 



SD 

UREQP 

OEUIDENT 

LKFZCNT 
UDIOFZCNT 
HODA 
LODA 
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Global Region Header (Rniqned Reqxont) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



lfi-24 



RB-23 
RB-22 
RB-21 
RB-20 
RB-19 
RB-18 
RB-17 
R6-16 



-I--I--I--I--I- 



-I--I--I--I--I--I--I--I 



REGION ASSIGNDENT STATE I RAS 

A |R |A |C IS |L IF |I |L Mllllllllllllllim I 

S IE |V |L |C |K |Z |0 |S I/////////////////II I 

S IS | IN | IP IN IF |T I/////////////////IP | 

I I ID I I I IZ IT I/////////////////I | 

I I I I I I IN I I/////////////////I | 



REGION SIZE 



-I 

I RS 



fltnory nanagtuent 



Subresion Header fRssiqned Regions) 



1 2 3 4 6 6 7 I 9 10 11 12 13 14 15 
..|..|..|..|..|_|„|..|..|..|..|„|..|„|..|„| 

SUBREGION BSSIGHntNT STATE I 
C IR IR I//////////////////////////////I I I 
R IE |0 | llllllllllllllllllllllllllllll I D I 
C IF |C I//////////////////////////////I S | 
H I I I//////////////////////////////I T | 
1 



iiiiiiiiiiiiiiiiiiniiiiiiiiiiiiiiiiiiiiiiiiiin 



SUBREGION SIZE 



I SS 
-I 



RB-13 V | SUBREGION DISPLACEnENT IN AWN BEN. PAGES I SO 



lllllllllllllllllllllllllllllllllllllllllllllltt 



Mllllllllllllllllllllllllllllllllllllllllllllin 

I I 

I lllllllllllllllllllllllllllllllllllllllllllllll I 

I 1 

I lllllllllllllllllllllllllllllllllllllllllllllll I 

I I 

I /////////////////////////////////////////////// 1 

I - I 

I lllllllllllllllllllllllllllllllllllllllllllllll I 
I I 



RB-12 

RB-11 

RB-9 
RS-8 
RB-7 
RB-6 
RB-5 
RB-4 
RB-3 



URITE REQUEST POINTER 
OBJECT IDENTIFIER 



-I 



I UREQP 
OBJIOENT 



FREEZE COUNT 



I LOCK COUNT 



URITE DISABLE COUNT I I/O FROZEN COUNT 

LDEV | HIGH ORDER DISC ADDRESS 

LOU ORDER DISC ADDRESS 

iiiiiiiiiiiiiiiiiiiiiiiiiiuiTiTiTiTiTiTiTiTiTi 
iiiiiiiiiiiiiiiiiiiiiiiiimiiiiiiiiiiiiiiiiiii 

THE OF 



LKFZCNT 
UDIOFZCNT 

HODA 
LODB 



I ARRTIHE 



ARRWBL 



iiiiiiiiiiiimiiiitiiiiiiiiiiiiiiiiiiiiiiiHin 
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Subregion Header (Cached Regions) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| — | — | — | — | — i — | — | — | — | — | — l — i — | — 1 — l — 

RB— 15 I SUBREGION ASSIGNMENT STRTE 

IC |R |R I//////////////////////////////I I 

Ifl IE 10 I ////////////////////////////// I 

ic if ic 1//////////////////////////////1 s 

IH I | | ////////////////////////////// I T 

I 

RB-14 | SUBREGION SIZE 

| 

RB-13 |V | SUBREGION DISPLACEHENT IN HfllN HEH. PAGES 



RB-12 

R8-11 



RB-7 

R8-6 
R8-5 



WRITE REQUEST POINTER 



OBJECT IDENTIFIER 



PREVIOUS CACHED REGION (ADDRESS OF PD 
FIELH OF PREVIOUS CACHED REGION) 



UREQP 
OBJIDENT 



LDEV 



I HIGH ORDER DISC ADDRESS I HODR 
j 

LOU ORDER DISC ADDRESS I UJDfl 
1 

NEXT CACHED REGION (ADDRESS OF ND I NO 
-I 

FIELD OF NEXT CACHED REGION) | 



TIflE OF 
ARRIVAL 
DISC ADDRESS CSL(8) 



-I 



[ CACDADISP 
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Region Header and Trailer Field Descriptions 



Region Assignnent State 

.(0:1) Region Assigned Flag 

.(1:1) Region Reserved Flag 

.(2:1) Region Available Flag 

.(3:1) Region Cleaned Flag 

.(4:1) Size Change Pending Flag 

.(5:1) Region Locked Flag 

.(6:1) Region Frozen Flag 

.(7:1) Region I/O Frozen Flag 

.(8:1) LSTT segnent, Region Hap Flag 

.(9:6) Not used 



.(15:1) Blocked Lock Higration in Progress Flag 

On-Going I/O Count 

- # of on-going I/O's in the region which nust complete 

before the initiation nessage can be processed. 



INITftSG, Initiation Message 

.(0:1) Dessage Processed Toggle Snitch 
.(1:1) flessage Externally Disabled Flag 
.(2:1) Message On-going I/O Disabled Flag 
.(3:1) Queue Segnent Read Disc Request Flag 
.(4:1) Incore Hove Request Flag 
.(5:1) Expansion Request Flag 
.(6:1) Garbage Collection Flag 
.(7:1) Message Aborted Flag 
.(8:1) Release Residual Pages Flag 
.(9:1) Ok to start conpletion flag 
.(10:5) Not used 
.(15:1) Message Valid Flag 

INITINFO, Initiation flessage Auxiliary Infomation 

= DRQ relative index of segnent read disc request if INITHSG. 
QREADREQ=1 

or 
= +/- Displaeenent to initiation nessage for noves 
and expansions. 

COtlPflSG, Conpletion nessage 

.(0:1) Nessage Processed Toggle Switch 

.(1:1) Segnent Modification Required 

.(2:1) Block Lock Request 

.(3:1) Send Scheduler A Message 

.(4:1) Awaken A Device 

.(5:1) Message Aborted 

.(6:9) Available 

.(15:1) flessage Valid Flag 
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HPQLINK PCB relative index of the HEAD of the tiake present 
queue. 

PA&ECNT, Release Page Count 

=# of extra pages to release before processing initiation 
nessage. 

SPECREQTABPTR, A Special Request Table relative index to the list 
of devices queued on this segnent. 

SAS, Subregion Assignnent State 
.(0:1) Cached region 
.(1:1) Referenced 
.(2:1) Recover Overlay Candidate 
.(13:3) I/O Status fron region fetch 



SS, Subregion Size 

SD, Subregion Displacenent 

.(0:1) Displacenent Count Valid Flag 
.(1:15) tt Pages to Base of Region 

UREQP, Write Request Pointer 

= DRQ Relative Index of Disc Urite Request when the 
Data Segnent in the Subregion is in notion Out 
Uhen the region belongs to a cached donain uhich 
is napped (i. e. OBJIDENT = 30000/non zero nunber) 
this Hord is non zero. If the cached donain is not 
napped UREQP is zero. 

OBJIDENT, Object Identifier- has standard object identifier fornat 

LKFZCNT, Lock and freeze count 

.(0:8) Nunber of tines region has been frozen 
.(8:8) Nunber of tines region has been locked 

UDIOFZCNT, Iofreeze count 

.(0:8) Not used 

.(8:8) Nunber of tines region has been iofrozen 

For regions belonging to cached donains, the above tuo uords 
contain the absolute address of the PD field in the previous 
region belonging to a cached donain. 

HODA, High order disc address in virtual nenory of this 

region 

I.ODR, Lou order disc address in virtual nenory of this 
region 

NO, Next cached donain link for cached donain regions 
only. Contains the absolute address of the ND field 
of the next cached region. ( 2 uords ) 
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ARRTIrtE, Arrival tine, contains the tine at which the segnent 
contained in the region becane present 

CACDADISP Valid only for regions containing a cached donain, 

this word represents the disc address ( in one worn ) 
of the segnent contained in the region. This uord 
uhich exists in each nenber of a linked list of cached 
donains, is used as the target uord during the LLSH 
instruction. 



Space Allocation Structures 



As of flPE V/P and V/E, one doubly linked list structure is used instead of 
the nultiple lists ordered by size as in MPE IV. Sysglob locations X250 
through Z253 contain the respective head and tail (bank 4 address) of the 
available region list. These four words have in essence replaced the ARSBH 
and ARL data structures in APE IV. Henory allocation and deallocation is 
handled through PUTQNARL and THKEOFFRRL. The search for an available region 
of the desired size is done via the LLSH instruction. The fornat of the list 
is the follouing : 

Sysglob X250 & X251 points to the absolute address of the NEXT LINK 
field (tuo uords) in the first available region on the list. The 
NEXT LINK field in the first available region points to the ab- 
solute address of the NEXT LINK field in the second available 
region and so on. It is worth nentioning that in addition to 
having a NEXT LINK field, each available region also contains a 
PREVIOUS LINK pointer, uhich nakes nanagenent of the list both 
easier and faster. 
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CHAPTER 3 DISC LAYOUT 
Systen Disc Layout 



* 01 



DISC LABEL 
1 i DEFECTIVE TRACKS/SECTOR TABLE 

2| COLD LORD CHANNEL PROGRAB FOR HP-IB 

31 rsn duup channel program for hp-ib 
I 

4 



CODE FOR - 
INITIAL PROGRAM 
"BOOTSTRAP" ■ 
SEB1ENT 



LOU CORE (CST POINTER, QI, ZI, POINTER) 



TEBPORARY CST (INITIAL PROGRAM) 
INTERNAL INTERRUPT HALTS 



BOOTSTRAP STACK 



REHRINOER OF SIO COLD LOAD PROGRAB 
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Systen Disc Layout (Cont.) 



H \ 



VARIABLE 
LENGTH 



<--| FOLLOUS 

I IMEDIATELY 

I AFTER 

| BOOTSTRAP 

I SEGHENT 



Disc Layout 



SVSDB 
> 

11 30/1 31 


SYSTEB DIRECTORV 




VIRTUAL HEBORY AREA 




INITIAL PROGRAB SEGBENTS 
(EXCEPT BOOTSTRAP SEG) 




SYSTEB FILES 
(FROn COLD LOAD TAPE) 




VOLUBE TABLE 
TNITIAL PROGRAM STACK 
REMAINING INITIAL CODE SEGMENTS 




USER FILES 



-> NOTE: INITIAL 
TRIES TO 
ALLOCATE 
DIRECTLY AFTER 
THE FREE SPACE 
I1AP. HOUEVER, 
THIS HAY 
VARY DEPENDING 
ON DELETED 
OR REASSIGNED 
TRACKS 
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SECTOR » 
Z 



Systen Disc Layout (Cent.) 









DISC COLD LOAD INFORHATION TABLE 


DISC COLD LOAD INFORMATION TABLE 


DISC COLD LOAD INFORMATION TABLE 


SYS0UI1P/INITIRL COMMUNICATION RECORD 


DISC COLD LOAD INFO. TABLE EXT. 


DISC COLD LOAD INFO. TABLE EXT. 
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Systen Volune 



Disc Label (Sector of Disc) 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 

0| 
| 

11 o 

I 

21 
| 

31 
| 

4| 
| 

51 



iuiiiiiiiiiiiiiiin 
i 

7 

10 
I- 

111 

I- 
121 

I 
131 



151 



DISC TYPE | DISCSUBTYPE 



Uords 0-5 contain 
the ascii string 
'SYSTEM DISC " for 
the systen disc, only. 



IF UORD Z11 
CONTAINS A "1" 
A FORMER SYSTEB 
VOLUHE HAS BEEN 
SCRATCHED. 



24 1 

I- 
25 1 



26 1 



ICF UCS 
II1AGE 

POINTER 
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Disc Layout 



Svstan Velum (Com.) 
271 



RESERVED 



1221 

I- 
1231 

I- 
124 



HEW 



SECTOR 



1701 

I- 
1711 



I- 



OISC FREE SPACE HAP OK FLAG 



1120 
-I 
1121 

I 



1721 OISC FREE SPACE IMP DESCRIPTOR TABLE CHECKSU1 |122 



-I 



1731 DISC FREE SPACE DESCRIPTOR TABLE DIRTY FLAG |123 
| 1 

"41 1124 

I-- DISC FREE SPACE DESCRIPTOR TABLE ADDRESS -| 

"SI |125 

| 1 

"61 |126 

| DISC FREE SPACE BITI1AP ADDRESS 1 

177| |127 

I , 
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Disc Layout 



Serial Volune (Cont.) 



27| 
122J 


RESERVED FOR FUTURE UCS 


123 

is2 


1231 


CYL 


183 


1241 


HEAD | SECTOR 


184 



1 HEDIA TYPE is the device subtype for ill serial volume except cartridge 
tape. For certridse tape, this field is aluays (the HP 9110 subtype), de- 
spite a different actual cartridge tape subtype. This allous both forwrd 
and backuard interchangeability of cartridges betMeen the MP9110 and HP 
9144. 



Raster Volune 








Ol 
U 
2! 
3| 
4| 
51 







|0 

H 
12 
|3 
|4 
IS 


SC = SCRATCH 6|SC|nV|SR| 


IS 


TVPE 


11112 SUB-TYPE 1S|6 



101 
111 





18 
19 


121 
131 
141 
161 


VOLUNE 
NAI1E 


MO 

1" 
112 
113 


161 


INITIAL DATE 


114 


171 


DIABASE 


115 


201 


DIRSIZE 


116 



15 IF NOT 
RASTER 



21 1 




221 


ACCOUNT 


231 


NARE 


241 





117 
118 

us 

120 



0.01.00 
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Disc Layout 



Serial Volune 



+ . 



— t 



(:STORE) 



COLDLOAD SIO CHANNEL PROGRAfl (NON-HP-IB 
RACHINES ONLY). FOR HP-IB RACHINES, COLD 
LOAD CHANNEL PROGRAfl IS IN SECTOR 2 AND 
SOFTDUNP CHANNEL PR0GRRI1 IS IN SECTOR 3. 4 

111111 
1234S678801234SS 
+— +— t— + + + 1 



6|SC|flV|SR| 



71 



I TYPE 



101 

I 
111 

+- 
121 

+-■ 

131 

+- 
141 

+- 

151 



IHEDIA TYPE* 1 6 

7 

8 

19 
-+ 
110 



SC a 1 "> 

SCRATCH VOUIRE 
hV * 1 »■> I1ASTER 

V0LW1E OF PV SET. 
SR » 1 «> 

SERIAL DISC 



"E" 



111 I VOL NAUE 

I 
112 



I 



161 UORDS PER SECTOR 



I SDISC VERSION NUflBER |13 
-♦ 1 

114' 

■♦ I 

115 I 

■♦ I 

116 | 



I "SERDISC" 

I 
I 



17| SECTORS PER TRACK (CARTRIDGE TAPE • 1) 
+ . „. _.„ 

20| SECTOR ADDAESS OF BEGINNING Of TAPE (SOT) 



21 | DOUBLE ADDRESS OF 

I- 
221 END OF TAPE (EOT) 



117 



DOUBLE ADDRESS OF 
END OF DATA (EOD) 



118 I 



I SERIAL 

> DISC 

I INFO 



25 1 
26I 



CYL 



SECTOR 



119 
-I 
I20 

- + 

121 
-+ 
1 22 



ICF UCS 

MAGE 

POINTER 
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Disc Layout 



Raster Volune (Cont.) 



2SI 
261 

271 
301 

311 
321 
331 
341 

351 



GROUP 

NAUE 



VOLUNE SET 



VS VTAB 

HEADER ♦ 

8 ENTRIES 3E|0 VCOUNT 3| 

COPIED FRON 

VSET DEFN 37 | 

IN SYSTEH 40| 

DIRECTORY 41| 

421 



VOLUNE 

NAUE 



431 

44| SUB-TYPE 

451 



121 
122 
123 
124 

125 

126 

127 HEAOER 

128 

129 

130 

131 
I32 

133 VOLUNE 

1 34 ENTRY 



I35 
I36 
1 37 



1161 



178 



voiunE 

ENTRY 
7 



1701 

I- 
1711 



Disc Free Space nap OK flag 



1120 
-I 

1121 
-I 



172| DISC FREE SPACE OESCRIPTOA TABLE CHECKSUM 1 122 



I- 



-I 



1 731 DISC FREE SPACE DESCRIPTOR TABLE DIRTY FLAG |123 
I I 

174| |124 

I- DISC FREE SPACE DESCRIPTOR TABLE ADDRESS -1 
1751 |125 



I- 

1761 
I- 

177| 



DISC FREE SPRCE BITI1BP ADDRESS - 



-i 
1126 



1127 
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Disc Layout 



Slave VgluHj 



01 
II 
21 
31 
41 
SC = SCRATCH 5| 

V0UJI1E 

IN = HASTER 

VOLUIIE = 

SR = SERIAL 

VOLUIIE 



6 1 SC | RV 1 SR | 


|6 TVPE 11112 SUB-TYPE 


1516 


71 


GENERATION INDEX 


17 


1C| 





IS 


HI 




19 


121 




110 


131 


VOLUtlE 


111 


141 


HAHE 


112 


151 




113 


161 


INITIAL DATE 


114 


171 





115 


201 




116 


211 




117 


22| 


ACCOUNT 


118 


231 


NAHE 


119 


241 




|20 


251 




121 


251 


GROUP 


I22 


271 


NA11E 


|23 


301 




I24 


311 




I25 


321 


VOUME SET 


I26 


331 


NflHE 


I27 


341 




1 28 
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Disc Layout 

Slave Volune (Cont. ) 



1701 
I- 
1711 



DISC FREE SPACE NAP OK FLAG 



1721 DISC FREE SPACE DESCRIPTOR TABLE CHECKSUn 



1731 DISC FREE SPACE DESCRIPTOR TABLE DIRTY FLAG 



- DISC FREE SPACE DESCRIPTOR TABLE ADDRESS 



177| 



• DISC FREE SPACE 8ITI1AP ADDRESS ■ 



120 
121 
122 
123 
124 
125 
126 
127 



G.01.00 
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Disc Layout 



Defective Tracks Table (Sector 1 of Disc) 
(Not Used On CS-80 Discs) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
..|..|..|..|..|..|-|-|-|--|-|-|--|--|-|--l 

It OF DEFECTIVE TRACK ENTRIES (N) |0 
1 

DEFECTIVE TRACK HUI1BER I DTC 11 120 DEFECTIVE 

I TRACKS tiRxinun 

DEFECTIVE TRACK NUNBER I DTC 12 



167| 

I- 
1701 

I- 
1711 

I 
1721 

I 
1731 

I 
174| 

I 
1751 

I- 
1761 

I- 
1771 



DEFECTIVE TRACK NUflBER 



I DTC 



DEFECTIVE TRACK NUHBER 



I DTC 



RESERVED FOR 
FUTURE USE 



1122 
i 
1 123 



1124 
I 
1 125 



NEXT AVAILABLE ALTERNATE TRACK |126 
1 

LOGICAL DISC PACK SIZE (CYLINOERS) 1127 



OR # OF TRACKS IF FH DISC 

DTC (DEFECTIVE TRACK CODE) 

suspect 

1 suspect alternate 

2 deleted 

3 reassigned 



Disc Layout 

Defective Sector Table (DSCT -- Sector 1 of Disc) 
(the DSCT exists on device type 3 (CS-80) discs, except cartridge tape) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

♦--I--I--I--I-I--I--I--I--I--I--I--I--I--I--I--* 

| NUtlBER OF ENTRIES IN THE TABLE I 

4 4 

Z1 I INDEX TO THE FIRST ENTRY (6) I 1 
+ + 

it | ENTRY SIZE (2) I 2 

4 4 

23 | riAxinun NUIIBER OF ENTRIES (61 ) I 3 

4 4 

» I (RESERVED) I 4 

4 4 

K I (RESERVED) I 5 

4 4 

Z6 | FIRST DEFECTIVE SECTOR ENTRY I 6 

I (DOUSLE-UORD LOGICAL SECTOR ADDRESS) I 

4 4 

Z10 I SECOND ENTRY I 8 

I I 

4 4 

112 I THIRD ENTRY I 10 

I I 

I J 

I ' I 

t + 

Z176 I nflXIttUfl DEFECTIVE SECTOR ENTRY | 126 

Z177 | | 127 



Unlike the DTT, entries in the DSCT are not pemanent. Once a suspect sector 
is handled by INITIAL, SDISC, or VINIT, its entry is renoved f pom the table. 
Thus, this table contains only unprocessed suspect sectors. 



NOTE: The situation uhere there are tuo entries for the sane track, n, one 
having a DTC of (suspect) and the other having a DTC 3 (reassigned) results 
fron a situation uhere the disc driver could not "read" (unreadable) the ad- 
dress of the particular track. 



G.01.00 



G.01.00 
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Disc Layout 

Reserved Area in Mao (Sector 4 of the Svsten Disc) 

The f imt 400 sectors of the systen diec art reserved for Initial's uti. 
This ana contains pernanent data structures for the boot. It is also used 
as a tenporary storage area for data during eparing. fill other systen 
volunes and private volunes reserve only the first 10 sectors of the diec. 
They do not have a reserved area bit nap. 

The bit nap contains 1 bit per sector, A T neane the eector is free. 

^...................-..-..............— ..+ 

to I 

RESERVED AREA 
911 HAP 



Z30 
H1 



X177 | 



RESERVED FOR 
FUTURE USE 



I 127 
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Disc layout 



Disc Cold Load Information Table (Sector. 88-30) 












POINTER TO TABLE INFORMATION 


FBEFTR ) 

TCSTPTR 

NREAD 

NVTCST' 

INITDB 

INITDL 

INITZ 

INITQ 

INITS 

DISCTST 

COLD' LOAD' ID' 

LOG'FILE'NUIT 

DIRADR 
VIRNEHAODR 

RINAOR 

DIRSECT 

SECTORS IK L0EV1V11 

RINSECT 
RINS 


1 


POINTER TO TEMPORARY CST INFO 


2 


• OF ENTRIES TO REDO ON DISC COLD LOAD 


3 


« OF CODE SEGMENTS IN INITIAL 


4 


INITIAL'S 09 VALUE 


5 


INITIAL'S DL VALUE 


S 


INITIAL'S Z VfiLUE 


7 


INITIAL'S Q VALUE 


8 


INITIAL'S S VALUE 


9 


| SYSDISC TYPE | SUBTYPE 


10 


COLO LOAD ID 


11 


LOG FILE NUMBER 


12 
13 


DIRECTORY DISC 
ADDRESS 


14 
15 


LOEV 1 VIRTUAL MEMORY 
DISC ADDRESS 


16 


• LOG PROCS 


17 


LOO ID'S 


18 
19 


RIN TABLE 
DISC ADDRESS 


20 


OIRECTORY SIZE 


21 


•SECTORS IN VIRTUAL MEMORY REOIOH OF LOEV 1 


22 


UNUSED 


23 


RIN TABLE SIZE 


24 


• OF RINS 
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Disc Layout 



Disc Cold Load Infornation Table (Cont.) 



| 1 

251 N of global RINS I (WINS 

| 1 TL=Tape cold load 

26| |TL|RL|RY| LOAD HODE 

| 1 R|*Reload 

I I RY=recovery 

27| HIGHEST VOL » I ■ OF VOLUMES I H'VOL' 

| | 

28| DISC COli UfflO ENTRY POINT I DISCENTRY 

| 1 

291 SYSTEM DISC DRT NUMBER | SYSDISCORT 

| 1 

30| JOB MASTER TABLE I 

I I JMATLOC 

31 1 DISC ADDRESS I 

| 

32 1 

I 
33 1 

I 

34! 

I 
35! 



IDO DISC ADORESS 



37 1 

I- 
38 

39 

40 

41 

42 

43I 
44 1 
45 1 



ODD DISC ADDRESS 

UELCOME MESSAGE (OST 47 
DISC ADDRESS 
UELCOME MESSAGE (DST 48 
DISC ADDRESS 



10) 



10) 



LOG ID ADDRESS 



LOG TAB ADDRESS 



LOG ID SIZE 
LOG TAB SIZE 



IDDLOC 



Disc Cold Load Infomation Table (Cont.) 



0.01.00 
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SIZE IN UORDS | 


MEMORY ADORESS 


•ORWER | 
TB6LE I 


DISC ADDRESS I 


SIZE IN UOROS i 


MEMORY ADDRESS 


*CTBBO I 


DISC ADORESS i 


SIZE IN UORDS I 


MEMORY ADDRESS 


•CTflB | 


DISC ADDRESS I 


SIZE IN UORDS 


* i 
— CONHUNICA-I 
TION SUB- | 
SYSTEN | 
DRIVER { 


MEMORY ADDRESS 


DISC ADDRESS 




SIZE IN UOADS 


* I 


MEMORY ADDRESS 


HON SUB- I 
SYSTEN ] 
DEFINITION! 


DISC ADDRESS ! 

j 

i 
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Disc Layout 



Disc Cold Load Infomation Table (Cent.] 



SIZE IN UORDS 


conitUNicfl- 

SUBSVSTEn 
TABLE 


I1EI10RY ADDRESS 


DISC ADDRESS 


SIZE IN UORDS 


HEIWRY ADDRESS 


LOGICAL- 
PHySICAL 
DEVICE 


DISC ADDRESS 


SIZE IN UORDS 


PtFHBRY RDDRESS 


LOOICAL- 

OEVICE 

TABLE 


DISC ADDRESS 


SIZE IN UORDS 


i 

MEMORY ADDRESS 


DEVICE 
CLASS 1 
TABLE 1 


DISC ADDRESS 


SIZE IN UORDS 


MEMORY RDDRESS 


VOLUHE 
TABLE I 


DISC ADDRESS 





FAEFTR+35 
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Disc Layout 



Disc Coid Load Information Table (Cont. ) 



SEGMENT SIZE 

DEFDATA 
MEMORY RDDRESS TABLE 
LOOK-UP 
BUFFER 

DISC ADDRESS 



(INITIAL'S SEGMENTS) 
ININ 



INITIAL Prwan CST flap 



JJGICRL 


PHYSICAL 






CST* 


CST* 


SEGMENT NAME 







1 


ININ \ 




1 


2 


BOOTSTRAP | — 


-> core resident 


2 


3 


RESIDENT / 




3 


4 


NAINSEG1 \ 




4 


5 


rmiNSEMA | 




5 


6 


CONFIGURE I 


Inoncore resident 


e 


7 


OEFCTRACKSI 


Ifaut present in core 


7 


10 


SETUP | — 


— I at conpletion of 


10 


11 


TAPEIO I 


I cold load 


11 


12 


FILEIO I 




12 


13 


DISCSPBCE / 




13 


14 


DIRECT0RY1 




14 


15 


DIRECT0RY2 




15 


16 


SL PROGRAM 




16 


17 


PROCESS 




17 


20 


NBINSEG1B 




20 


21 


NAINSEG2 




21 


22 


MAINSEG3 




22 


23 


flRINSEG4 





*code segnent swapping starts at conpletion of I1AINSEG1 
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Disc Cold Load Information Table fCont. ) 



HEttDRV RDDRESS 



LOGICAL 
DEVICE 
TABLE 
EXTENSION 



STACK SIZE 



MEMORY ADDRESS 



INITIAL'S 
STACK 



DISC ADDRESS 



SIZE IN UORDS 

DEVICE 

MEMORY ADDRESS CLASS 

TABLE 

HEADER 



DISC ADDRESS 
SIZE IN UORDS 



MEMORY ADDRESS 



TERMINAL I 
DESCRIPTORI 
TABLE 



DISC ADDRESS 



SEGMENT SIZE 



MEMORY ADDRESS 



INITIAL/ 
SYSDUHP 
COMMUNICATION 
— RECORD 
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Disc Layout 



SYSDUMP/Initial Connunication Record (Sector 31) 



NIT VERSION 



VERSION 
UPDATE 



FIX 



EXP SYSTEM NR. 
HIGHEST DRT 
HIGHEST LDEV 
HIGHEST VOL/It OF VOLS 
• OF ADO'L DRIVERS 



COLD LOAD COUNT 
FILES DUMPED 
SERIAL DISC LOAD 
TAPE RECORD SIZE 
DISC COLD LOAD ENTRY 



|-|-|- F=(13:1)Set if FOS Sysdunp 

iFiuiSi D=(14;1)Set if future date Sysdunp 

l-l-l-l S=(15:1)Set if serial disc Sysdunp 
I 



MAX INITIAL SEG SIZE 

SPARE 

SPARE 

SPARE 

DEV CLASS TAB SIZE 



TERN DESCRIPTOR SIZE 
OLD VTA6 SIZE 
OLD INFO SIZE 
CS TABLf SIZE 



G.01.00 
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Disc Layout 



IVSDUnP/Initial Connunicatlon ima (Cam.) 



26 


TABLE LOOKUP BUT SIZE 


26 


TABLE LOOKUP BUF ENTRIES 


27 


SVSTEH TAPE LOW « 


26 


SPARE 


29 


SPARE 


3D 


CONVERSION BITS WAD 1 In 


31 


CONVERSION BITS UORD 2 


32 


CONVERSION BITS UORD 3 


33 


CONVERSION BITS UORD 4 


34 


SPARE 


35 
36 


SPARE 

SPARE 


37 


SPARE 


36 


SPARE 


39 


SPARE 


40 


LOG FILE HUflBER 



■ (15:1) UPE Virtion 

■ NPE G.00.00) 

1 ■ WE (0.01.00) 



One Layout 
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Virtual Disc Space Banaqenent Structural 



Disc space for data eegnents it allocated fron rcMrved regions of systen 
volunes uhich have been assigned the virtual nenory supporting (VNS) at- 
tribute. The data structure used for accounting and nanagenent of the vir- 
tual disc space of the various VHS volunes is the Virtual Disc Space Table 
(VDSHTRB). This structure consists of a circular list of entries, one for 
each VHS volune. Each entry contains the infomation defining the state of 
the virtual nenory region on that volune. 



Virtual Disc Space Nanagenent Table 



VDSNTAB DSTN = 39 (147) 

VDSBTflBPTR - Hbsolute(I1026) = SYS6L06 126 



general Structure 



>| # WHS VOUJUES 

I FIRST TO LOOK AT 

4 

■ >| 

♦ — I NEXT IN LIST 

I I 

| t 

♦~>| 

♦ — | NEKT IN UST 

I I 

| t 

♦~>| 

1 NEKT IN LIST 

I 
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Cold Laid Infomation Tibia IxioMim 



The Cold Load Infomation Tabu (xtaneion li i part of the Cold Load 
Infomation Tabli that has no net in booting the lyatttt, It axittt for dif- 
ferent ayeten level proetntt to hold infomation that uould only be created 
during a RELOAD. R good exenple of thlt is the systan log file nunbtr. This 
it only created on a RELOAD, int changed uhenevir a log file 1* full or I 
boot (other than a RELOAD) is ptrfomtd. 

In order to protect the Cold Load Info Tabli, tha extension uat created, In 
this Hay NO I/Ot should be ptrfomtd to the Cold load Infomation Tabli 
during BPE operation. Houevar to proctto data into the Cold Load Info 
Extension a process nust use tha access routine "PROCESS'COLD'LOAD'INFO", 
The exact calling sequence can be found in KERNELO. 

The Cold Load Infomation Extension is 2 sectors long and immediately follow 
the SYSDUBP/Inltial Connunication Record starting at lector address H31 on 
logical device 1. 

The assigned entrite are ae follow: 






RESERVED FOR FUTURE SYSTEM USE 



SYSTEM LOGGING FILE NUMER 

NETUORK BANAGEBENT LOGGING FILE NUrfflER 



NETUORK BANRGEBENT TRACE FILE RUBBER 



FULL/PARTIAL M1HRN0 DUBP DATE 



NOT CURRENTLY ASSIGNED 



21 
22 
23 
24 
26 
26 
27 
2! 

i 255 
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VDSBTBB Entry Foroat 

1 2 3 4 6 6 7 8 9 10 11 12 13 14 15 
|„|_|_|..|..|..|„|„|..|..,_|„|„|_|„,„ 

VOSNTA800] BJUOROS IN WSHT 

| 

WSniABOl I N SVSTEH VOLUMES UHICH HAVE VIRTUAL BEBOCY 

| 

V0SNTAB02I INDEX OF NEXT ENTRY TO ALLOCATE FRON 

| 

V0SBTA803I VB PAGE SIZE (512) 

VDSHTAB04I « SECTORS/VN PAGE (4) 

VDSBTAB05I OFFSET FROB ENTRY TO BITBRP (120) 

| 

V0SHTAB06I TOTAL I VN PAGES CONFIGURED IN SYSTEB 

VDSBTAB07I LEAST It OF VN PAGES THAT HAVE EVER BEEN AVAIL. 
| 

I 

I VDSBTAB 210-217 UNASSIGNED 



TAB L£ LENGTH 

VNSVOLUNECNT 

STAATENTRY 

VNPAGESIZE 

SECTORSPERVnPAGE 

OFFSETTOBN 
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VDSBTAB General Entry Fornat 





1 2 3 4 S 6 7 S 9 10 11 12 13 14 15 


Uord 


INDEX OF NEXT ENTRY IN CIRCULAR LIST 


(lord 1 


LDEVN 


Uord 2 


STORTING SECTOR OF DEVICE'S 


Uord 3 


VIRTUAL BEBORY REGION 


Uord 4 


* SECTORS IN DEVICE'S 


Uord S 


VIRTUAL n£IHJ*Y REGION 


Uord S 


« PAGES IN DEVICE'S VIRTUAL BEBORY REGION 


Uord 7 


• OF PAGES AVAILABLE IN DEVICE'S VII REGION 


Uord Z10 


• OF VALID UORDS IN DEVICE'S SIT HAP 


Uord Z11 


SIZE OF SnALLEST RECENT DISS 


UORD Z12 


SBRLLEST NUBKR Of PAGES EVER AVAIIA8LE 


11 3-120 


UNASSIGNEO 




DEVICE'S VIRTUAL BEBORY SIT BAP 




1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 




i I 1 i 1 i i i i i i i i i i 1 

1 



Diic Layout 



NEXTINLIST 

LDEV 

HOSTRRTSECTOR 

LOSTARTSECTOR 

TOTAL SECTOR 

COUNT 

TOTAL PAGECNT 

PRGESAVAILABLE 

8H LENGTH 

sballestbiss 



Disc Layout 



***COBBENT: fl bit on in a device's VBBIT BAP 
•~> Corresponding VE1 page is free. 
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Typical Private Volune Entry 





1 
2 
3 
4 
5 
6 
7 

101 

I 
111 

I 
121 

I 
131 

I- 

I 
14! 

I- 

I 
15! 



INDEXED 8Y 
VOLUttE » 



VDLUBE 
NABE 



GROUP 
NABE 



ACCOUNT 
NABE 



LOGICAL DEVICE # 
(^ IF NOT BQUNTEP) 



[VnSIUNIMSISC 

I I I I 



IVSET VTA8X I 
I I 



NON-SYSTEB 
DOBAIN 

■ SCRATCH 

■ UNREADABLE/ 
UNFORBflTTED 
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Volune Table 



SIR «22"Z2S 
DST H29-I35 



uord 

1 
2 
3 



zerfl entry 
1 2 3 4 5 6 7 ! 9 10 11 12 13 14 15 
-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 
» OF ENTRIES I 

(NOT COUNTING ZERO) I ENTRY SIZE=16(S) 



COLD LOAD ID 



SYSVOLNUB 



VIRTUAL BEBORY INTEGRITY RUBBER 



\S\UIIHIIIIIIIIIIIIIItlllllllllHIIIIIIIIIIIIIIIM 
I 1 
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Typical Svsten Volune Entry 




10t STARTING SECTOR OF VOLUBE'S VB (0 IF NONE) 

I 
111 

| 

121 

| NUBBER OF SECTORS RESERVED FOR VB ON VOLUBE 
131 (0 if none) 



| 

I LOGICAL DEVICE * I 
14| (=0 IF NOT BOUNTED) I 

I IVSET VTABX I 

151 I I 
! 



|VBS|UN|NS|SC 
I I I I 



INDEXED 8Y 
VOLUBE II 



NS • 

sc ■ 



BVTABX 



NON-SYSTEB 
DOBAIN 
SCRATCH 
UN - UNREADABLE/ 
UNFORBflTTED 
vTC - VIRTUAL BEBORY 
SUPPORTING 



G.01.00 



Directory 



CHAPTER 4 DIRECTORY 

Introduction to the Directory 
SYSGLOB cells: 

OIRBBSE < absolute disc addr of base [SVSSUJB+I130 AND 2131] 

Directory on disc consists of a contiguous area: 



DIRBASE -> 



-I 



DIRECTORY 
BITIWP 



DIRECTORY 
DATA 

Entries 

and 
Indices 



The bitnap defines the available/used 
I sectors in the directory. If the 
directory is <= 6112 sectors, then 
the bitnap Mill occupy 3 sectors. 
If the directory size is > 6112 
sectors, then the bitnap uill occupy 
32 sectors uith DIR6ASE pointing to 
the 30th sector of the bitnap. A 
zero bit in the bitnap represents a 
used sector. Uords and 1 of the 
bitnap are ignored. 



i 

I Directory entries contain pointers 

j uhich are sector displacenents 

relative to DIRBASE. Entries and 
I indices are grouped into "blocks". 



The capacities for accounts/groups/users/files in dependent on their 
block sizes. 

* SYSSAIBSIZE Systen acct index block size (3 sectors) 
SYSAUIBSIZE Acct. user index block size (1-3 sectors) 
SYSAGIBSIZE Acct. group index block size (1-3 sectors) 
SYSGFIBSIZE Group file index block size (2 sectors) 
SYSGVSIBSIZE Group volune set definition ind. blk. size(1 sector) 

* SYSAEBSIZE Acct. entry block size (3 sectors) 
SYSUEBSIZE User entry block size (2 sectors) 
SYSGEBSIZE Group entry block size (2 sectors) 
SYSFEBSIZE File entry block size (2 sectors) 
SYSVSEBSIZE Volune set definition entry block size (1 sector) 
SYSBAXBSIZE llaxinun of above, (used to initialize DOS.) 

*These values are used once for the creation of the (root) systen. 
account index or neu system:. This root index is always at address 
DIRBASE+3. 
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Overvieu of Directory 



I SYSTEH I 

/ / \ \ 
/ / \ \ 
/ / \ \ . . . 

ACCOUNTS 

I I I I 
I I I I 

' I "\ 

I \ 

I \ 

I \ 

I USERS I I GROUPS I 

I I ~\ I \ \ 

I I \ I \ \ 

.... .... .. .... .... .... 

I I I I I I I I I I GROUPS 

\ " " / / V" 
/ \ 

USERS / \ 

/ \ 

I VSETS | | FILES I 

'/ /" 7"\ 

I I I \ 

I I I \ 

VSETS/ II I I I I I I FILE 

KEY: VCLASSES I I I I I I II POINTERS 

i i i"i 7" 

| | / 

INDEX / 

ENTRY FILE 

Overvieu of Directory 
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directory 



Directory Data Seqnent 



| 1 o 

. I SECTOR | . 

BUFFER 

128(10) UORDS 

177 | | 127 

| 1 

200 | ADJUST (DB-DL) I 128 
| 1 

201 | XTYPE (INPUT PARtl) | 129 
| 1 

202 I : XIWTABX I 130 
| 1 

203 | XINDEXP (FINAL INDEX PRT)| 131 
| 1 

204 | XAHAI1E (DB REL AODR) I 132 
| 1 

205 | XGUNAHE (DB REL ADDR) I 133 
| 1 

206 I XFNAnE (DB REL ADDR) I 134 
| 1 

207 | XASEC (ACCOUNT SECURITY) I 135 
| 1 

210 | I 136 
l-XGSEC (GROUP SECURITY) -I 

211 I I 137 
| 1 

212 I SIRRETURN (FROM GETSIR) I 138 
| 1 

213-240 DIRECTORY POINTER "A" 

| 1 

241-266 DIRECTORY POINTER "B" 

I I 

267 | SYS.ACCT.INDEX BLOCK SIZEI 183 
| 1 

270 | LDEV : DIRECTORY I 184 



139-160 \ 

> SEE Directory 
161-182 / Pointer Area 



I- 

271 | PV DIRECTORY SIZE I 185 

| 1 

I PRIVRTE VOLUTIE DIR. SIZE I 186 
| 1 

I//////////////////////////I 187 

I — -I 

I lillllllllllllllllllllllll I 188 
I - I 

i iimiiiiiiiiiiiiimiiiii i 189 
I 1 

\llllllllllllllllllllllllll\ 190 
| 1 

Miiiiiiiiiiiiiiiiiiiiiiiin 191 
i i 



Directory 

Directory Data Sequent (Cont. ) 












lllllllllllllllllllllillll 


192 




lillllllllllllllllllllllll 


193 




lillllllllllllllllllllllll 


194 




lillllllllllllllllllllllll 


195 




lillllllllllllllllllllllll 


196 




lillllllllllllllllllllllll 


197 


306 

M0tS>ERCENT=.85 
307 


DISTRIBUTION 
FACTOR 


198 
199 


310 


BASE 


200 


311 


DA AREA 


201 
D0S8USIZE 










UORK AREA 
(SIZE OF LARGEST ENTRY) 


MAX 








1145 


DB AREA 


613 
DDSBUSIZE 
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Mmttn Pttnwr Hrw tM u MI MWoho) iliiUlfl 



LDEV I DIRECTORY MX 

MIMESS OF PAGE IN BUFFER 



DIRECTORY PAGE IN BUFFER 



01 ADDRESS OF 1ST ElEIICNT 



STMTINO RODRESS OF BUFFER 



• VAUO PACES IN BUFFER 



Ol 



EUSKENT SIZE 



* UORDS UXD IN BLOCK 



BLOCK SIZE (SECTORS) 



BLOCK SIZE (IWROS) 



IWII « ELEIKNTS/BLOCK 



•l-l-l- 



-I- 



IIPI TVIELEHENT SIZEIBLOCK SIZE 

I I I I WORDS) I (SECTORS) 

.|.|. H 1 

NIHWER OF ELEIKNTS 



NUtlBER OF ACCESSOAS 

ENTRY TOTAL 
-l-l-l- 



OtPI TYIENTRY SIZEI BLOCK SIZE 
-l-l-l-l (UORDS) I (SECTORS) 



l-l-l-l- 



-I- 



FATHER INDEX POINTER 



I 



-R--I- 



139/161 0IR6ASE1' 




140/162 DIRBRSE2' 




141/163 CONTENTS 




142/164 LPNTR 




143/166 IOPNTR 




144/166 NLWRUD 




14S/167 D-DIATY FLAG, B'BAD ELEBENT 


146/168 XSIZE 


NOTE; 


147/169 USED •» 

141/170 BSIZE 

* 

149/171 BUSIZE 


INDEXES AND 
ENTRIES 

INDEXES ONLY 


160/172 BFBCTOR 




161/173 F1ISCU0 




162/174 KCOUNT 




163/175 PCOUNT 




154/176 ETOTAL 




155/177 EMISCIIO 




156/17S PINOEXP 




167/179 




15S/1S0 PMFH1E TY 

159/181 

160/182 

I 

P 


- O-FILE 

1 -CROUP 

Z-RCCT 

3-USER 

4-VSD 
" O-ENTRY BLOCK 

1 -INDEX BLOCK 
■ PURGE FLAG 
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Directory Snice Dati Sumnt (DIRSDS) 



DST-21 (X25) 
SIR»8 



DST « 21 ( HB ) 

111111 
0123456789012345 



logical device Bit nap 
bin sector address 



Ptr to lilt iviil uord in buff 



Ptr to firet uord in bufftr 



Sin in nctore of directory 



OIEISIPI 
Firtt current outer in buff 



Dioc address of current port 
of bit nip in tht buffer 



OS' BASE 

OS'LAST'UORO 

DS'FIRST'UORO 

DS'DIR'SIZE 

OS'FLAGS 

DS'CUR'SECTOR 

i DS'ADDR 



Size of bufftr in words 
Nttrt requested otctor 



Loot otctor in bit nop 
Syottn tavad pntr to loot 



Systen ooved pntr to firot 
Syoton oovtd current otctor 



Saved directory size 
LDEV that last error occurred 
Type of error that occurred 



DS'SIZE 
DS'RCO' SECTOR 
DS'LAST'SECTOR 
OS 'SYS' LAST 
DS'SYS' FIRST 
DS'SYS'CUR 
DS'SYS'SIZE 
OS'ERROR'LDEV 
OS'ERROR'TYPE 
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Directory 



This section of the bit nap 
DST is occupied by up to 3 
sectors of bit nap. It is 
suapped in 3 sector* at a 
tine as needed. OS" FIRST 'WHO 
is updated to search for 
space in the bit nap. Uhen 
it reaches OS' LAST 'UORD for 
the second pass, the next 3 
sectors of bit nap uili be 
suapped in. 



OS' WW. (0:8) 
DS'FLBGS.(0:1) 
DS'FLA0S.(1:1) 
DS'FLAGS.(2:1) 
DS'FLBGS.(3:1) 



Partial definitions: 
OS' LDEV 
OS'DIRTY 
OS'ERR'IN'PROG = 
OS'OIR'DISWLED= 
OS'PERI1'0ISA8LE= 

Descriptions: 

DS'ADDR 

This is the address of the section of bit nap that is currently in the buf- 
fers. For exanple, this address uill usually be the sane as DS'BASE. IF ue 
need to page in nor* sectors of bit nap than the first three, then this ad- 
dress uill be subsequently larger than DS'BASE. 

DS'BASE 

This is the base address of the directory bit nap. If the directory is 
greater than 6112 sectors, then this address uill be 29 sectors less than tht 
address found in the Cold Load Infornation table on disc. 



This is the current bit nap sector nunber of the first sector in the buffer 
area. Its value can range fron 1 to 30. This nunber ninus one added to 
DS'BASE uill result in DS'AOOR. 

OS 'DIR' DISABLED 

If this bit is on, the directory allocation and deallocation is off and only 
a URRnsTRRT uill turn this bit off. The bit is turned on if an I/O error oc- 
curs on a directory bit nap sector or if ue find data integrity problens uitr, 
the bit nap, i.e. if ue attenpt to deallocate a sector that is already 
deallocated. 
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DS'DIR'SIZE 

This is the size (sectors) of the directory area. This size includes only 
the last 3 sectors of the bit nap. If the directory is greater than 6112 
lectors, then this size does not include the extra 29 sectors of bit nap. It 
can also be thought of is the nunber of bits in the bit nap. 

OS'OIRTY 

This bit is set if the bit nap sectors in the buffer have been nodified in 
any uay. Uhen nore sectors mist be brought into the buffers, or if ue suitch 
to a different donain (systen to PV, PV to systen) this bit is interrogated 
to deternine if tht sectors presently in the buffers nust be first uritten to 
disc. 

DS' ERROR 'LDEV 

The LDEV in uhich the last directory error occurred. 

OS'ERROR'TYPE 

This uord describes the type of directory bit nap error that occurred. Its 
legal values are: 

- No error 

1 - I/O error on a urite 

2 - I/O error on a read 

3 - Attenpting to deallocate space that is already deallocated 

4 - Directory space nanagenent is already disabled 

DS'ERR'IN'PROGRESS 

A directory space nanagenent error is currently in progress. 

DS'FIRST'UORD 

R DST relative pointer to the uord in the bit nap buffer that ue uill in- 
terrogate next uhen directory space is needed. Uhen the systen first cones 
up, this uord is aluays initialized to DS'HERDER+2 (i.e. to point to the 
first uord in the bit nap). On subsequent bit nap sector rtads, it is set to 
DS'HEADER since subsequent sectors will not have the 2 uord overhead that ex- 
ists in the first sector of the bit nap. 

DS'FLAGS 

This uord contains nunerous Flags. See individual descriptions. 

DS'LAST'SECTOR 

This is the total nunber of active bit «ap sectors. This nunber will 
range fron 1 to 32. 
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DS'LflST'UORD 

This is the current nunber of bit nip wont in the buffer. It can range fron 
1 to Z577 t OS'HEADER. If there exists 3 full sectors in the buffer, 
then it Mill have the value Z600 ♦ OS'HEAOER - 1 or Z621. It is conpared to 
DS'FIRST'UORD to deternine if ue have hit the end of the current buffer 
area. 

DS' PERU' DISABLE 

If this bit is set, then directory allocation/deallocating is permanently 
disabled. This bit should not be set. 

OS'REU'SECTOR 

This is the next sector to begin reading in up to 3 bit nap sectors. It is 
updated by 2 or 3 and the read procedure uill bring in up to 3 sectors 
starting fron this sector. If this sector is set to be greater than 
DS'LBST'SECTOR, then it is reset to 1. 
DS'CUR'SECTOR is set the DS'REO' SECTOR. 



After the sectors are read in, 



DS'SIZE 

This is the size in uords of the bit nap buffer area. It is aluays a Mul- 
tiple of a sector (12S uords). It uill usually have the value of Z600. 
Legal values are Z20O, Z400 and Z600, 

DS'SYS'LBST, DS'SYS'FIRST, DS'SYS'CUR & DS'SYS'SIZE 

The values of DS'LflST'UORD, DS'FIRST'UORD, DS'CUR'SECTOR and DS'SIZE uill 
be stored in these locations uhen the directory space nanagenent suitches 
fron the systen directory to a private volune directory, find, of course, 
uhen DSn suitches back to systen donain, the above nentioned values are 
reinitialized Hith these values. 



Directory 
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Directory Definitions 



>PAGE - snallest allocatable record ("phys.recd")-currently sector. 
>BLOCK - integrant of pages; contains contiguous indices or entries. 
>INDEK - pointer to entry block, containing nane of 1st entry. 
>ENTRY - infornation-containing "object" nay contain pointer to an 

index block. 
>POINTER - 15-bit positive relative page nunber (relative to directory 

base). 
>ODS - directory data segnent. 
>ELEI1ENT - a generic nane for index or entry. 

Index Block Prefix (10 Uords) 



->| INDEX SIZE (UORDS) 
I 7 BITS 



O-FILE \ 

1 -GROUP I 3 bits 

Z-flCCT |< I 

3-USER / I I 

4-VSET I I 

| | >| BLOCK SIZE (SECTORS) 

PURGE FLRG<— - I I I I 4 BITS 

I I I I 

nlSCLD 0|1 |P| TY | XSIZE |BSIZE|0 INDEX BLOCK INFO. 

,| vrnntjT 11 NUn R F» QF THhFX POINTFRS 

1 :".'.:.._ -i' 

2| IPCOUNT 12 HUtlBER OF BCCESSORS* 

I "I 

31 ETOTflL 13 ENTRY TOTALS 

l-l-l— -I -I I 

EMSCUD 4I01PI TY | EXSIZE |EBSIZE|4 ENTRY BLOCK INFO. 

5| PINDEXP 15 INDEX POINTER OF FfiTHER 

I 1 

El 16 \ 

I I I 

7| 17 I 

| PtmtlE | >NBI1E OF FATHER 

10| IS I 



Directory 



111 
1= 
I 



19 



I 



*The count is increnented by each access that uses and relies 
upon a pointer to the index block, i.e., it is guaranteed not 
to be purged uhile the count is not = 0. 
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Directory Structure 

INDEX BLOCK 




INDEX PREFIX I 


INDEX PREFIX I 




ENTRY BLOCKS 


ENTRY I 


ENTRY I 


ENTRY I 





ENTRY 
ENTRY 



ENTRY 
ENTRY 
ENTRY 



The Index Block prefix points back to 
the previous higher level. The Index 
Block entries point to the entry blocks. 
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Index Entry 16 Uords) 



JO 1st NFfflE OF ENTRY BLOCK 



4 POINTER TO ENTRY BLOCK 

5 NUHBER OF ENTRIES IN e BLOCK 

Account Entry (Z36 Uords) 



I I 

0| |0 

I I 

1| |1 ACCT.NAI1E 

| ANAnE I 

21 12 

\ \ 

4| flGIPNTR |4 ACCT. GROUP INDEX POINTER 

I - I 

5| AUIPNTR IS flCCT.USER INDEX POINTER 

.1 ■ ! 

i BCAP I CAPABILITY 

1 1' 

101 18 

| ALBTTR I LOCRL ATTRIBUTES 

111 19 

I— I 

12| |10 PRSSUORD 

i I 

131 111 

i RPASS I 

14| 112 

I I 

151 113 

I— - - I 
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Recount Entry remit.) 



16 
17 
20 
21 
22 
23 
24 
25 
26 
27 
30 
31 



AOFSCOUNT 



I CISC FILE SPIKE COUNT (SECTORS) 



AOFSUMT 



I DISC FILE SPACE LIBIT (SECTORS) 



ACPUCOUNT 



acpulbiit 



rcoHTirecouHT 



BCONTIHELiniT 



I- 



CPU TME C0UHT (SECONDS) 



CPU TME LIfllT (SECONDS) 



CONNECT TINE COUNT MINUTES) 



CONNECT TIIIE LMIT (MNUTES) 



---321 I/I//I I I I | | | 126 FLAGS (SEE BELOU) 

33IS|R|/////| |27 tmx.joe PRIORITY 

| 1 1 

34IC0IH1 FILE REC « RCCTI28 connand file location of 
| j accour rt y& cs 

35 1 COW! FILE REC « SVS 129 connand file location of 
I 1 system udes (SYS acct only) 



HARD CODED 

1 

1 I 



Directory 



Croup Entry (K1 unrdt) 



I PI//I/////I R | R| n I R| U I U 
l->BSECU| | //| /////| ANY |AC|ANY IACIANY IRC 
|~|--|-|._|..._,_.| 1„, 1„ 

\ 



P PURGE flag 



1--| 1-| 1-| 

LIU X | X| S | S| 
ANY |AC|ANY |RC|ANV |AC| 
— -I--I— -I--I l-l 

I 

I 
FILE SECURITY 



S If 1, systen level UDC't exist (only in "SYS" account) 
A If 1, account level UDC't exist for account 
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Group Entry (Cont. ! 




1 
2 
3 
4 
5 
6 
7 

10 
11 
12 
13 
14 
15 
16 
17 
20 
21 
22 
23 
24 
25 
26 



GNANE 



GFIPNTR 



GPASS 



CROUP NABE 



GROUP FILE INDEX POINTER 



COFSCOUNT 



GDFS LIBIT 



GCPUCOUNT 



GCPU LIBIT 



GCONTINECOUNT 



GCONTME LIBIT 



•PI 



9 DISC FILE SPACE COUNT (SECTORS) 

10 

11 OISC FILE SPACE LIMT (SECTORS) 

12 

13 CPU TIKE COUNT (SECONDS) 

14 

15 CPU TIDE LIBIT (SECONDS) 

16 

17 CONNECT Tine COUNT (BINUTES) 

18 

19 CONNECT TIME LIBIT (BINUTES) 
I 

1 20 
-I 

121 BROUP SECURITY (SEE BELOU) 

I *P = PURGE FLAG 
-I 
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Oirectory 



Group Entry (Cont. ) 



GLINKAGE (0:1) =0; HVS is in Systen Donain 

(0:1) ■ 1; HVS it in Private Volune Donain 

(8:8) = 0; If not W or Not Bound 

(8:8) <>0; If PV and Bound 



CROUP SECURITY I1ASK 
| — |— | — I— I — I— I — | — I — I — I — I— I — | — I— I — 
I P I///I A I R I R I R I R | A | A |fl | A | A | U | U | U U 

25| I///IANYIAC IAL [CO |GL IBNYIAC IAL IGU IGL IANYIAC |At !GU 
|~| — | — I — I — I — I — | — I — I— I — i — I — i— — i — 
! u I 1- I 1- I L I L I L | X | X | X | X | X | S | S | S I S S 

26 GL IANYIAC |AL |GU IGL |ANY|AC |AL IGU IGL |ANY|AC |AL IGU GL 
| — I — I— I— I— I— I — |— I — I— I — I — I — ! — ! — | — 



File Entry (File Pointer)(6 Uords) 



(Definition's vol set nane) 



138 SAVE CELL FOR GFIPNTR 



47| GflOUNTREFCNTR 
I 

50| 
I 



139 GROUP BIND COUNTER 
-I 

140 GSPARE 



I- 



1 2 3 



G LINKAGE 

8 9 10 11 12 13 14 15 



IPV Ullllllllllllllllllllllllln 



10 FILE NAME 



FNflNE 



FVTABINX | 
I 



|4 VOL TRBLE INDX / FILE LABEL DISC 

I ADDRESS 

15 



i - Bad file label 
(0:1) = - net defective 
= 1 - defective 
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User Entry (19 Uordt) 




1 
2 
3 

4 

5 

6 

7 

10 
11 
12 
13 

14 
15 
16 
17 

JO 

unaxjobu 21 

22 



UCP.P 



UHGROUP 



ULOGCOUHT 



*P I U| I J08PRI 
-I- 



conn FILE REC It 
(connand file loc of 
user udcs) 



USER NAflE 

1 

2 

3 

4 CAPABILITY 
S 

6 LOCAL RTTRIBUTES 
7 

5 PASSUORD 
9 

10 
11 

12 HonE group (bay be null) 

13 
14 
15 
LOG CUT (II OF USERS LOGGED ON) 

16 INIT TO 1 FOR flANAGER.SYS SO 
THIS USER CANNOT BE PURGED 

17 WW. JOB PRI;*P=PURG£ FUG 

U=UDC EXIST FLAG 
18 
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Uwr Attributes/Capability 



FILE-ACCESS ATTRIBUTES < 



SAVE FILES 



I 
\ NON-SHBRABLE DEVICES- I 

COtWNICATIONS I I 

NODE flflNBGER I I I I 

NETUORK BDniNISTRBTOR I 



USER 



ATTR 



SYSTEfl flGR 

ACCOUNT flGR 

ACCOUNT UBRN 

GROUP UBRN 

I DIAGNOSTICIAN 

I | --SYSTEfl SUFVSR 
I I I CREATE VOLS 
I I I I USE VOLS 



I I I I I USER LOGGING 
I I I I I I SYSTEn PROCESS HANDLING 
PROGRflnnBTIC SESSIONS 
I I I I I I I I I I I Mill 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
|Sn|fin|AL|GL|OI|OP|W[UV|LG|SP|PS|NB|Nn|CS|ND|SF| 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
l//l//l//l//l//l//l//|BA|IA|Pn|//|//|nR|//|DS|PH| 



/ batch access 

I interactive access 

ACCESS j privileged node 

TO < 

GENERAL I Multiple RINS 

RESOURCES I extra data segnont 
\ process handling 



I I I 
-I I ! 
1 I 



I I 

I I 

I I 

I I 

I I 
-I I 
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Volune Set Definition Entry 



TY|A|2 



5IV0L COUNT |4 



IWTBBX 
VHBSK 



/ 61 

I 7| 

VOLUnE I 10| 

ENTRY < 111 

(6 WORDS) I I — 

I 1210 



14| n 



\ 131 PSEUDO SUBTYPE I 





/ 141 


VOLUflE 


1 . 1 


ENTRIES 


1 • 


1 - 7 


< . 



10 

11 

12 
13 
-I 
|4 

|5 

16 
|7 
IS 
|9 

10 

11 

12 



Directory 



VOLUflE 

SET 

NAI1E 

GVSUNKAGE 

GVSINFO 

HEflBER VOLUflE 
NBI1E(1ST ENTRY 
IS NflSTER 
VOLUflE) 

GVSVOLFLBGS 

GVSVOUNFO 



Directory 



G V S L I N K A G E 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



NOT 
USED 



\ 571 



I . 
|47 



611 

I 
621 

I 
631 

I 
641 

I 
651 



BEfl. VOL. 
NOTE 



GVSVOLFLfi&S 


(ncneER voujriE flags} 


GVSVOUNFO 


(lOBER V0LUI1E INFO) 


GVSDREFCNT 


(OEFN. REF. CNTR.) 






I 

TY = VOLUtlE SET DEFINITION 

= 1 VOLUnE CLASS 
IWTABX: flOUNTED VOLUflE TABLE INDEX (IF flOUNTED) 
VOL COUNT: NO. OF VOLUnES 
VflASK: VOLUflE I1ASK 
B = NOT nOUNTEO 

= 1 flOUNTED 
VTBBX: VOLUflE TABLE INDEX 
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1 49 
I 

1 50 
I 

1 51 
I 

152 
I 
153 



155 SPARE 



I T | A | 

i I I 
| 



T - TYPE 

- Volune Set Definition 

1 = Volune Set Class 
A - ALLOCATING FLAG 

= not initially allocating (not 1st user of set) 

1 = 1st user of set allocating resources (transitional) 
ITVTA8X - nounted Volune Table Index 

if volune set not logically nounted 

GVSINFO 



1 2 3 



5 6 7 8 9 10 11 12 13 14 15 



NOT 
USED 



I VOLCNT | 

I I 
| 



VOLCNT - Nunber of nenbers in set 
VSflASK - Bit nask of volune nenber usage 
Order is fron right to left 
i.e., bit 15 is 1st nenber, bit 14 is 2nd nenber ... 

GVSVOLFLBGS 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
| | 

I NOT USED I fl | 

| L_| 

n - nenber flounted Flag 

= not nounted 

1 = nounted 

GVSVOLINFO 

1 2 3 4 6 6 7 8 9 10 11 12 13 14 15 



| DISC 
I PSEUDO SUBTYPE 



DISC PSEUOO-SUBTYPE = (Actual type *16) t actual subtype. 
VTBBX - Volune Table Index 
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V»l¥"«, W H'W WV 



111111 
0|1:2:3|4:5:6i7:«:9IO:1:2l3:4:S 




1 
2 

3 

4 

5 

t 

7 
10 
11 
12 

13i 

I- 
141 

I- 
15| 

I- 
161 

I- 
171 

I- 
201 



221 

I- 
231 



GVCWWE 



GVC LINKAGE 
GVCINFO 

GVCPNBME 

wtmm 



o 

1 

2 

3 

4 

5 

$ 

7 

t 

9 

10 

11 
-I 

112 
-I 

113 
-I 

1 14 
-I 

115 
-I 

116 
-I 

117 
-I 

118 
-i 

119 



VOLWIE CLASS NAME 



VOLUME CLASS IDENTIFICATION 
VOLUME CLASS INFORfBTIOH 
PARENT VOLMIE SET OEFINITIQN 

ACCOUNT OF PARENT DEFINITION 



CROUP OF PARENT DEFINITION 



VSNBUE OF PARENT DEFINITION 
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Directory 

E1X1JJJLUJ 

12 3 4 5 5 
I- 



7 8 9 10 11 12 13 14 15 



I T I Mlllliilillillilltlllllilllllllllllltllllimillllllll I 



-I 



T - TYPE 

1 ■ Volune Set Definition 
■ Volune Sot Cl«< 

OV C I N F 



5 6 7 ! 9 10 11 12 13 14 15 



VOLCNT 



NOT 
USED 



I 



VCHASK 



VOLCNT - Nunbtr of nenbere in «t 

VMASK - Bit natk of volune nenbtr wage (VOLWIE CLASS MASK) 
Order i» fron right to left 
'i.e. bit 15 it lit nenber, bit 14 ii 2nd nenber ... 

Volune Bath Fomat 

- USED IN AVTA6, fWSER, FILE CONTROL BLOCK (FCB), 
VOLUME SET/CLASS DEFINITION, VOLUME SET VTAB. 

- S-BIT BASK. 



I V7 | V6 | V5 | V4 | V3 | V2 | V1 | VO 



I I 



0: NOT MOUNTED OR NON-MEMBER 1: 



— VOLUME (MASTER) 

- VOLUME 1 

- VOUfflE 2 

- VOLUME 3 

- VOLUME 4 

■ VOLUME 5 

■ VOLUME 6 



VOLUME 7 

MOUNTED OR MEMBER 
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SIR* allocation DST 153 



Sir's Ordered 


by Sir Nunber 




SIR » 


RRMK 


sir mm 


1 


10 


LOAD PROCESS 


2 


335 


CACHE CONTROL 


3 


91 


100 


4 


92 


000 


5 


50 


PROCESS TREE STRUCTURE 


6 


60 


SCHEDULING QUEUE 


7 


70 


CST ENTRIES 


S 


SO 


SYSTEtl DIRECTORY 


9 


90 


LPDT 


10 


85 


IDT 


11 


110 


STORAGE IN OVERLAY BRER 


13 


130 


JPCHT 


14 


140 


JCUT 


15 


27 


J HAT 


16 


5 


FIKWT 


17 


22 


LOADER SEGtlEHT TABLE 


18 


180 


TOO 


19 


190 


SPOOL 


20 


200 


I1ESSAGE CRTBIBSUE 


21 


210 


RIT 


22 


220 


VOLUtffi TABLE 


23 


230 


UELCOHE MESSAGE SIR 


24 


240 


ASSOCIATION TA8LE 


25 


250 


CS ALLOCATE 


26 


260 


LOGGING BUFFER 


27 


83 


PV nVTRB 


28 


280 


HEASSIR 


29 


290 


PV USER TABLE 


30 


300 


IMflGE 


31 


310 


KSfifl 


32 


320 


USER LOGGING 


33 


330 


DEBUG BREAKPOINT TABLE 


34 


340 


PCB 


35 


350 


SUB-QUEUE MAPPING TABLE 


36 


360 


CI LOG 


37 


25 


FILE INTEGRITY 


38 


380 


RIN 


39 


390 


TAPE LABELS 


40 


87 


DEVICE CLASS TABLE 


41 


400 


Reserved 


42 


401 


Cold Load SIR 


43 




1st JOB 


44 




2nd JOB 
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SIR Table Info nut ion 



The systen internal resource table is located in non-linked nenory (resident 
table). The SIR table is used to protect critical systen elettents against 
access by mire than one process, i.e., it provides a "lock out" neehanisn. 
Each critical systeti resource (usually a table) is assigned a specific SIR 
nunber. Procedures are provided uithin tPE to lock (GETSIR) and unlock 
(RELSIR) the SIR. Processes attenpting to obtain a SIR that is not available 
are inpeded by tha systen. The SIR table entries forn the head of a linked 
list in this case. If (tore than one process becones inpeded, word 15 of the 
PCB entry is used to add the "new" process to the growing list. The Method 
of uninpeding the process depends on the SIR type. 

fl SIR does not respect process priority and operates in a FIFO nanner. Uhen 
a process is added to the end of the queue, the priority of the holder of the 
SIR and the priority of all intervening processes are increased. They are in- 
creased to the priority of the newly requesting process. 

To get SIRs, arrange the SIRs in ascending order by rank. To release SIRs ar- 
range the SIRs in descending order by rank. For exanple: 



GETSIR (LOT) **Rank=85** 
GETSIR (000) **Rank=92** 



RELSIR (ODD) **Rank=92** 
RELSIR (LDT) **Rank*35** 
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Sir's Ordered bv Ranking 




BANK SIR f 


SIR NATjE 


5 16 


FHAVT 


10 1 


LOAD PROCESS 


22 17 


LOADER SEGJ1ENT TABLE 


25 37 


FILE INTEGRITY 


27 15 


JtWT 


50 5 


PROCESS TREE STRUCTURE 


60 6 


SCHEDULING QUEUE 


70 7 


CST ENTRIES 


90 8 


SYSTEI1 DIRECTORY 


83 27 


PV hVTAB 


85 10 


LDT 


87 40 


DEVICE CLASS TABLE 


90 9 


LPDT 


91 3 


IDO 


92 4 


ODD 


110 11 


STORAGE IN OVERLAY AREA 


130 13 


JPCNT 


140 14 


JCUT 


180 18 


VDD 


190 19 


SPOOK 


200 20 


HESSBGE CATALOG 


210 21 


RIT 


220 22 


VOLUHE TABLE 


230 23 


UELC05E HESSAGE 


240 24 


ASSOCIATION TABLE 


250 25 


CS ALLOCATE 


260 26 


LOGGING BUFFER 


280 28 


HEASSIR 


290 29 


PV USER TABLE 


300 30 


IBBGE 


310 31 


KSffll 


320 32 


USER LOGGING 


330 33 


DEBUG BREAKPOINT TABLE 


335 2 


CACHE CONTROL 


340 34 


PCB 


350 35 


SUB-QUEUE HAPPING TABLE 


360 36 


CI LOG 


380 38 


RIN 


390 39 


TAPE LABELS 


400 41 


Reserved 
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SIR Entry Fomats 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I 10 free 
| 1 

I 11 (not locked) 

! 1 

| 12 

| 1 

I 13 

| 1 

| 1 

I PCB index oF holder |0 SIS locked 

| 1 

[ |1 (nn inpeded processes 

| 1 

I 12 

| 1 

I 13 

| 1 

| 1 

I PCB index of holder 10 SIR locked 

| 1 

| SIR QUEUE LENGTH |1 (inpeded processes) 

| -~j 

j HEAD OF IfiPEDED LIST(PC5 relative; i2 

I - I 

| TAIL OF INPEDED LIST(PCB relative) 13 
| 1 

P = PIN* 

PIN = PCB table entry nunber 

SIR QUEUE LENGTH- nunber of processes queued for this SIR 

The SIR table is indexed by SIR*, uith each SIR* corresponding to a unique, 
pre-assigned systen internal resource. Entry NO is not used. Inpeded lists 
are established by using the SIR table entry (2) as the head of the list and 
PCB(15) for elenents. PIHs are aluays used as pointers, uith indicating 
end of list. 
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RIH Table General Lawut fl nitialiesd State) 



DST-IZ6 



RT=RIN TYPE 
(UHEN 
RLIOHED) 



1-LOCRL RIH 
2-GLOBAL 
•CIM 

3-FILE RIH 



INDEX OF FIRST FREE ENTRY 



(# LOCBUtUWtL RIHS)*3 



RT I 



INDEX OF NEXT FREE 



tlllllllllllllllllllllllllllllllllltlllllllllll I 

l<- FIRST 
-- FREE 

I ENTRY 
I 

! 
I 



«T I 



MOEX OF NEXT FREE 



<- 



I RT I 



O(EOL) 



SECONDARY |- 

TABLE OF 12- | 

mm ENTRIES I- 



FREE UST POINTER 



TOTAL MF ENTRIES 



FOR GLOBAL 
RIN'S ONLY 



NUMBER FREE ENTRIES 



RESERVED 



IIF FREE, PIT TO NEXT FREEI 
| 1 



LOST 
<- FREE 

ENTRY 



LENGTH- 

• ALLOCATED 

GLOBAL RHS 

•12 

I I 
I I 
1- 



110 

111 
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Allocation and Lockino of file RTHS 



Leek Resources 



RIN TABLE 



DST22(10).2t(») 



INKX OF FIRST FREE ENTRY 



(NIKR OF LDCflltUOBRl RINS)*3 



lllllllllllllllllll/ltllllllllllllllllltlltlltl 



I milllllllllllltllllllllllllllllllllllllll 



PIN OF HOLDER 



HEM) OF UNITING UST(P) 



■> PtBR Mailing processes PCBN proem that 
linked through PCB "holds" rtn 

inpeded queue 

P-pinN 



I 

I 

< — 



Lech Resources 

Allocation and Locking of Local RINS 

RIN TS8LE 



DST22(10)»26(I) 



JOB INFOR 
NATION 
TRBLf 

"!!* 
I 
I 
|M3 

1 

LOCK | 

RIHI 

INDEX! 



OBEX OF FIRST FREE ENTRY 



(NUMBER OF L0CAL»GLOBAl MNS)«3 



lilllllllllllllllllllillllllillltllllllllllllll 



1| 



INOEX OF NEXT RIN 



II 



INDEX OF NEXT RIN 



II 



END OF LIST 



PIN OF HOIDER(P) 



HEW OF UNITING LIST 



I 

I 

-->PCBN waiting processes 
linked through 
PCB inpeded queue 
(PC8» pointers) 



PCBN PCBN of process <-- 
that "holds" rin 



LOCAL 
- RIN *1 

I (UNLOCKED) 

I 

I 

1 

I 

I 

:- LOCAL 
-RIN «2 

I (UNLOCKED) 

I 

I 



I 

I 
l<- LOCAL 
RIN «3 
(LAST) 
I- (LOCKED) 

I 

I 

I 

I 

I 

I 

I 



P » PI* 
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Allocation end Locking of Global Arcs 

RIN TABLE 



DST22(10>26(8) 



INDEX OF FIRST FREE ENTRY 



(NUHJER OF LOCRLtGUHAt SINS)*3 



/////////////////////////////////////////////// 



1 | INDEX OF PASSUORD, USERNftlE 



PIN OF HOLDER 



HEAD OF UNITING UST(P) 



Miting 
processes 



RIN PASSUORD 



USERNAHE 
(USER NRflE AND ACCOUNT) 



I 
I 
I 

I 
v 
PC8K 

process 
that 
'holds' 

RIN 
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P-pinN 

INDEX Of PASSUORD = RELATIVE TO BASE OF SECONDARY 
TABLE 
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CHHPTER 6 FILE SVSTEn 



This chapter describes the HPE V file systen. The second section describes 
the basic concepts. The third section describes the table structures used. 



File Systen Dvervieu 

I/O to files is done by reference to file nunbers, uhich are assigned by 
calling the FOPEN intrinsic. This establishes an initial "point of attach- 
nent", uhich nay be described as a connection between a progran (i.e., 
process) and that particular point in a particular file at uhich the next 
FREUD or FURITE uould cause data to be transferred, A point of attachnent is 
described by a control block, of uhich there are several different kinds 
(described later). Control blocks nay exist in the process's oun stack or in 
an extra data segnent assigned by the file systen. In order to Find control 
blocks quickly, a pointer schene called vectors is used, A control block is 
uniquely described by a vector, uhich consists of tuo uords with the first 
uord containing a segnent nunber and the second word containing a uord offset 
into the control table of the vector table entry uhich describes the location 
of the control block uithin that segnent. The entire assenblage, consisting 
of eight overhead uords, the vector table, and all of the control blocks to 
uhich it points, conprises the entire segnent; if in a stack, it occupies 
part of the PXFILE part of the PCBX. 

The point of attachnent is described by a "physical access control block", or 
PACB, uhich uill exist as a result of an FOPEN to any file (except sNULL). 
Any required I/O buffers are associated with the PACB; refer to Section J.I. 

nil FOPENs specifying "nulti-access" for all processes running under a single 
job use a single PflCB for references to a nulti-access file. Although all 
these are attached to a single point in the file, the type of attachnent 
(i.e., AOPTIONS) nay be different. So, each FOPEN specifying a nulti-access 
file establishes a "logical access control block", or LACB, uhich contains 
the point-of-attachnent local values. The use of a single buffer (i.e., 
PflCB) ensures that references by various processes or against various FOPENs 
uithin one process are dealt uith in strict sequential order. Note that 
references to a file by other jobs, or by other processes not specifying 
nulti-access, uill be through other PBCBs, whose buffers uill be read or 
uritten at the pleasure of the file systen; in order to ensure any sort of 
coherence to such shared references, the jobs nust use global RINS and FLOCK 
and FUNLOCK the file. tSTDIN, tSTDUST, and spoolfiles are opened nulti- 
access autonatically. 

In the case of disc files, there is another kind of control block: the file 
control block (FCB). It contains copies of infornation read fron the file 
label, such as the end-of-file pointer, the extent nap, and the record and 
block structure. The EOF pointer is updated in the FCB as the file is urit- 
ten, and all changes nade to the FCB are posted to the file label uhen the 
file is closed, fin FCB is shared by all jobs in the systen uhich reference 
the file. 
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File Systen 



This section gives a detailed discussion of the nain tables constructed and 
used by the file systen. The location and overall structure of each table is 
given, in addition to the table fornat and a discussion of each field in the 
table. Table indices at the right of the table are in octal. Index nanes 
apply to the entire uord; if in parentheses, the nanes are defined in the 
file systen listing but not explicitly used there. 

File Svsten Section of PCBX (PXFILE) 

The PXFILE area is a subsection oF the PCBX. It is a contiguous, expandable 
and contractible block oF storage that is nanaged by the file systen prinari- 
ly for its oun use. Other subsystens, nanely CS and DS, also nake use of the 
PXFILE section. In doing so they nust conforn to the conventions of the file 
systen. 

The overall structure of the PXFILE im is: 



OVERHEAD 



CONTROL BLOCK 
TABLE 



ACTIVE FILE 
TABLE 



(FIXED) 



(VARIABLE) 



(VARIABLE) 



(VARIABLE) 



I DL-5 
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The file nunber assigned by an FOPEN is an index into the Available File 
Table (AFT), a table of six-word entries which is at the end of the PXFILE 
part of the PCBX. Tuo double uords are vectors to the PACB and (if it ex- 
ists) the LACB. 

AFT entries can also reside in a global AFT extra data segnent. IF the File 
was opened Global AFT (specified in the AOPTIOHS) and the progran is 
privileged, then the AFT is placed into this global AFT DST. Any accesses to 
the file are identical to local BFT's. All accesses to the file opened 
global nust be done fron privilege node code. The file systen intrinsics 
distinguish this file by a negative file nunber. Again, these files are 
identical in every other uay except for where the AFT entry resides. 

Because control blocks are shared anong processes, it is necessary to have a 
schene for coordinating access to then. A control block is "locked" by a 
process uhich requires exclusive access to it for a tine. Other processes 
uhich attenpt to lock the block uill find it already locked, and uill be in- 
peded and queued. It nay also be necessary to lock an entire control block 
table so that a process can create or destroy a control block in it, or lock 
or unlock an existing control block in the table. 

Another table used by FOPEN is the File Nulti-Access Vector Table (FhUVT). 
This table exists in a systen extra data segnent and is used by all jobs and 
processes in the systen. Uhen a file is being FOPENed uith nulti-access 
specified, the FBAVT is searched; if the file is already open, the FtlAVT 
gives the PACB vector For the prior reference for each job. 



A bit in AOPTIONS specifies, uhen a file is opened, uhether access is to be 
buffered or unbuffered. If unbuffered, data is transferred directly between 

the I/O device and the user's buffer (usually in his stack), uhich uill be 

frozen in nenory for the duration of the transfer. If buffered, the data is 

noved betueen the user's buffer and a file systen buffer to uhich the I/O is 
actually done. 

Buffers are associated uith the PACB, attached to it as an appendage. 



G.01.00 
6- 2 



File Systen 



The part labeled Overhead contains inFomation that pertains to the 
entire section. It is addressed via the pointer at DL-3. 



1 



7 S 



I PXFILE SIZE IN UORDS 

LAST DOPE* ERROR NO. I LAST COPEN ERROR NO. 
N I 



LAST DS AFT 



SLAVE AFT UMBER 



I PXFSIZE 

-I 

I 1 
-I 

I 2 
-I 

I 3 
-I 

I 4 



LAST KOPEN ERROR NUI1BER I LAST FOPEN ERROR NUNBER 



AFT SIZE IN UOROS 
CS TRACE FILE INFO 



I 6 
-! 
I 7 



I S 



-I 



PXAFTSIZE 

(PXCTRINFO) 

PXFLEFTOFF 



i LAST RESPONDING NO-UAIT I/O AFT ENTRY NUNBER I 9 

| 1 

I 1ST USER (NDBUF) CONTROL BLOCK TABLE DST NUI1BER I 10 PXFCBT1 

I- -I 

! 2ND OSES (N08UF) CONTROL SLOCK TABLE DST HUHBER ! 11 (PXFCBT2) 

| | 

I 3RD USER (NOBUF) CONTROL BLOCK TABLE DST HUflBER I 12 (PXFCBT3) 

I 1 

| 4TH USER (NOBUF) CONTROL BLOCK TABLE DST NUHBER I 13 (PXFCBT4) 

I I 

I 5TH USER (NOBUF) CONTROL BLOCK TABLE DST NUH8ER I 14 (PXFCBT6) 

I - I 

I 6TH USER (NOBUF) CONTROL BLOCK TABLE DST NUT18ER I 15 (PXFCBT6) 

I - I 

I 7TH USER (NOBUF) CONTROL BLOCK TABLE DST NUnBER I 16 (PXFCBT7) 

I -- I 

I !TH USER (NOBUF) CONTROL BLOCK TABLE DST NUI16ER I 17 (PXFCBT8) 



Partial uord Field identifiers in: 



PXFOOPEK 
PXFCOPEN 
PXFNOCB 
PXFKOPEN 

PXFFOPEN 



= PXFILE(1).(0:8)», 
= PXFILEO). (8:8)11, 
• PXFILE(2). (0:1)11, 
= PXFILE(S). (0:8)11, 
= PXFILE(S). (!:<)•. 



last DOPEN error code 
last COPEN error code 
no CB's in PXFILE CBT' 
last KOPEN error code 
last FOPEN error code 
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Diecueeion: 
PKTAFTSIIE 

PXFCBT1-I 

mFCOPEH 

ntFcntiMFo 

phfdopen 

pxfdsihfo 
pkffopbi 

pkfkopeh 
wleftoff 



(WSIZE 



Fill Sytttn 



This i> tha tin {in uorda) of tin Active Fill Table (AFT). 
The eiza it in uorda to tinplify calculating Iht tin of 
the available bloefi. 

Then an the OST nunbere of tha war (ROBOT) control block 
tablee. fl OST nunber of indicatea that no data segment ia 
allocatad. 

Thia contain tha liat CWCH arror nunbar. Hot uaad by tha 
file tytten, 

Thia containt information partinant to tha CS tract fila. 
Not uaad by the fila ayttan. 

Thia contain the latt DOPE* error nunbar. Hot wad by the 
file ayaten. 

Reserved for OS. Hot wad by the fila ayattn. 

Thit containa the latt FOfEH error nunbar. If it ie ttro 
then the laat FOPEN auccetafully conplettd; otharuiae the 
latt FOFEH uat uneucceteful and tha nunbar ia the file aya- 
ttn error nunbar. 

Thit contain the laat KOPEN error nunbar. KSMI it partly 
enbedded in the file tyttan, and an FOPEN failure on a KSMI 
fila can be eauaed by a failure to open either the hey file 
or the data fila. Thit error nunber it uaad in conjunction 
uith PXFFOPEH to deternine uhich fila eauaed the KSMI open 
failure. Thia error nunber it not uaad by the file ayttan. 

Thia ia tha AFT entry nunber of tha laat file/Un that 
conpleted a nouait I/O; if zero than no nouait I/O hat been 
conplettd. Thia call ia Maintained tolely by and for the 
IOUAIT intrinaic. 

Thit bit tignifiet that control block! are not to be 
created in the PXFILE control block table. Thia bit ia tat 
by the HOCB paraneter to tha CREATE intrinaic or the :«UH 
connand. Thit ftature pemita the uter to have aa nut* 
tteck apace aa poetible; otheruiae the file tyttan Hill 
take teveral hundred uorda of atack for tha (WILE control 
block table. 

Thit it the eiza (in uorda) of the conplatt FXFILE ana. It 

ia the aun of the overhead block, the control block table, 
the active file table and tha available block. 
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File Jyaten 

Bctive File Table fBFTl 

The part labeled Active File Table contain inf ornetion utad by tha fila tyt- 
tan (or CS, DS, etc.) to groeely characterize tha fila acceaa and, mat 
inportantly, to jive the location of the control block*. 

The overall etructure of the AFT it: 



(FBEO, < OOTIDS) 



ENTRY H 



OL-9 

(FIXED) 
OL-5 



■here N • PXFAFTSIZE/6. 

The length of the OFT ia opacified by PXFAFTSIZE. United entriea are all 
zerot. then the tabic ia full it ia expanded by taking apace fron the 
Available block. 

The BFT it mgatively indexed by fila nunber: the entry at Dl-» correeponde 
to file nunber 1 , the entry at OL-15 corretponde to file nunber 2, etc. 

The ttructure of the global AFT OST, described in Section 2 ia at follow: 



ENTRY 0. HOT »SE0 I 
I 



I 00 «0 






I M » 6 



-I 
I D8»(N*6) 

I 
I 
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PXFILE Control Block table (PXFC8T) 



Addretting uithin a PXFILE control block table ia toneuhat nore conplicated 
than addretting an extra data tegnent CBT tince the table doet not begin at 
DfcO. At a rtault all pointers uithin the table m table relative; the 
atarting addrttl of the table mat be added to a pointer to generate a final 
OB-relative addrttl. Thit addrttting convention it continently applied to 
all control block tablet. 

Mien the control block table it expanded, apace ie taken fron the AVAILABLE 
area. If no apace it available then the PXFIIE area it expanded and the ac- 
quired tpace it added to the AVAILABLE area. 

Available Olock 

The part labeled Available it uted to provide tpact unen the Control Block 
Table or the Active File Table it expanded. Thete tuo tablet grou touardt 
each other, and uhen nore tpact it needed it it tinply taken fron the 
Available Block. 

Uhtn tha Available area it exhaueted, the (WILE area ia expanded, the AFT it 
relocated and the neu apace ie added to the Available Block. 

Currently the PXFILE area ia only expanded; it it never contracted. 
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Tha ttructure of a file ayaten AFT entry ia: 
1 2 J 4 5 



I entry TYPE |N| 



PHYSICAL ACB OST WWCR 



PHYSICAL ACS ENTRY ADDRESS 



L06KAL AM OST hUfJCP, 



I 

| 

! LOGICAL ACB ENTRY ADDRESS 

I HO-UAIT I/O IOW 



1 AFTPAC80ST 

2 AFTPAC8ENTRY 

3 AFTIAOOST 

« AFTLACBEKTRY 

5 AFTIOW 



Tha entry fornat deptndt on the entry type; the file tytten uttl entry type 
Tha Follouing partial uord field identifier! are uted: 



AFTTYPE 
AFTNULL 



Oitcuttion: 
AFTIOCX 



■ AFT.(0:«)», 
> AFT.(4:1)», 



entry type 
(HULL File 



AFTLACBOST 



RFTLACBERTRY 



AFTKULl 



Thit it tha I0Q index of the pending nouait I/O (if any). 
Thit it applicable if the file uet opened uith tha NOUAIT 
option ipecifitd. Aleo, CS and DS have the tint capability 
and ute thit cell in a contittent nanner. Thia it btcaute 
the IOMAIT intrinic atrvicet the file tytten aa uell at CS 
and DS, and ia the principal uter of thit call. If the 100* 
it negative, then on of tuo poatibilitiet exitt. If the 
file it a netitge file, then file 100* it the accettor't re- 
ply port. If the file it a ttandard HPE file, then a read 
uat done to a nonxittent extent and thit it tinply a atub 
inserted by the file tytten. 

Thit it the OST that the Logical ACB (LACB) if it exittt. 
Thit it applicable if the file uat optned uith the nulti- 
accest option opacified. 

Thit it the uord offtet into the control block table of the 
LACB vector table entry, applicable if the file uat opened 
uith the nulti-accest option apecified. 

Thit bit tignifita that the file it INULl and that there are 
no control blsjcki. 
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BFTPBCBOST Thii is the DST that contains the Physical ACS (PACB). A 

PACB exists for ill files except (MULL. 

BFTPACBENTRv This is the uord offset into the control block table of the 
PflCB vector table entry. This Kill be noniero for all files 
except MULL. 

BFTTYPE This is the AFT entry type nunber. Bt present the follouing 

entry types ere defined; 

- file systen 

1 - renote file 

2 - OS (nouait I/O disalloued) 

3 - DS (nouait I/O allowed) 

4 - CS 

5 - CS 

6 - KSBH 

S - ttessjge File 



Renote file BFT entry: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 IS 



1 
2 

3 



FSTVPE 


I UNUSED 


I-- 

w 




LINE NUI1BER 


— 




REflOTE FILE NUBBER 


PENDING FCUJSE DISPOSITION FR0T1 FOPEN 


UNUSED 


io« 




I 

BFT 

FSTVPE 

tlR 
RFT 1 
AFT 2 
BFT 3 

BFT S 



• This value Mill be 1 for renote files. 

- Set if the file uas opened nulti-access. 

- Local line nunber of renote file. 

- File nunber of the renote file. 

- Pending disposition of the file. Set when file uas FOPEN'd and 

uill possibly be used as the FCLOSF. disposition. 

- No nail I/O Queue Index. 
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OS BFT entry: 

1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 

1 FSTVPE I CI 111 PI R| DS ERROR NUI1BER 



DfiTH SEGflENT NUI1BER 



| DSDC6 INDEX I 
I- 



UNUSED 



I 



LDEV NUI1BER 



PREVIOUS RFT POINTER 



| 

RFT 

FSTVPE 

C 

n 
p 

R 
BFT 1 
BFT 2 
BFT 3 
BFT 4 
BFT 5 



I Ml! 



- This Field will have the value 2 or 3. 

- On if DSOPEH called by CXDSUNE or RENOTE'KELLO. 

- On if Hester PTOP RFT. 

- On if PTOP related. 

- On if renote nain process. 

- DS data segnent table pointer. 

- DSDSCB Index - DS data segnent control block index. 

- Logical device nunber. 

- Preceding OS open BFT Pointer. 

- IOQX - Sane as described above. 
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CS Line entry: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



File Control Block Table (C8TBB) 



l-l-l-l-l-l-l-l-l- 
I FVPE I Ul U|ID| 81 



-l-l-l-l-l-l- 



LOGICRl DEVICE NUMBER 



VECTOR TO MULTIPLE 100 INDICES 



I TR | II R| DIBLI 
| 



I 



fllSC'DST 



I- 



I0OX ( CIO only ) 



I 4 
-I 

I 5 
-I 



RFT 

FTYPE - This value will be 4 or 5. A 5 signifies that the line 

has an autodialer attached. 
U - The line has been opened uith no uaiting on I/O requests. 
ID - Line is a nultipoint control or 3270 station. 
B - Line uas opened uith buffering. 

- Logical device nunber of the line. 

- Vector to nultiple 100 indices. 



fl file control block table can be located in tuo places: (a) as a subpart of 
the PXFJ.LF. area, as discussed in Section 3.1.2; or (b) in a data segnent. 
Although putting control block tables in PXFILE has the advantage of provid- 
ing rapid access, it detracts fron the space for the user's stack; so the 
larger control blocks Cor optionally, all control blocks) are put into extra 
data segnents. On the other hand, referencing extra data segnents nay result 
in an absence trap, uhich is slou. Extra data segnent control block tables 
are of three kinds: expandable, nonexpandable, and shared FCB. 

Nonexpendable CBT's are used for a single PACB uith buffers, i.e., uhere the 
control block is large or uhere the control block can't be local to a single 
process (for nulti-access). Expandable (or NOBUF) CBT's an used for snail 
control blocks ,as LACB's, PBCB's uith no buffers, and FCB's uhich are local 
to a single process, fl list of the expandable C8T's associated uith a 
process is kept in the overhead area of PXFILE (cf. Section 3.1.1). Uhen a 
snail control block is needed, these CBT's are checked in order to see if one 
of then has roon. Shared FCB CBT's an sinilar to expandable CBT's except 
that they belong to the systen rather than to a single process; the systen 
keeps a list of DST's uhich it has assigned for this purpose. 

The overall structure of a control block table is: 



RFT 1 

BFT 2 

RFT 3 

TR 



I 

R 
DISL 



RFT 4 
BFT 5 



- Bit on signifies tracing enabled. Bit 1 on signifies 
trace all. 

- On if line is currently connected. 

■ Signifies that this CS device is an SCCP device. 

- = Dial on urite, ansuer on read. 

1 = flnsuer on urite, dial on read. 

2 = Rluays dial. 

3 = Never dial. 

- DST nunber of the line's nisc data segnent. 

• If <> 0, then it is the systen D6 address of a single request 100 
entry. IOURIT uses this uord to pass the 100 index of the con- 
pleted request for this BFT to CSIOUBIT. 
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(FIXED, 8 UORDS) 



(VARIABLE) 



(VRRIR8IF.) 
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"V« '•*«*' 



The part labeled Overhead contains information pertaining to tin ttttirt 
table. 



CBTSKE 

1 CBTWTN 
2 

3 CBTPIN 

4 CBTCONTROL 

5 (nrguEuc) 

6 
7 



1 


2 t 7 


15 


TABLE SHE III UOROS 


DST MMXS CONTAINING TABLE 


TVPt 


1 VECTOR TABLE SIZE IN WORDS 




LOCK PIN 


L 1 


INPEDED QUEUE HEM) 


INPEDED QUEUE TAIL 




UNUSED 





Other identifiers used: 



CBTTYPC • CBTW(Z).(0:2) Central block table type 
CBTVTSI7.E ■ C6Tf*(2).(2:14) Vector table size 
CBTLKKBIT' CBTCONTROL. (0:1) Lock bit 



Thie it the DST nunber oF the data segnent that con- 
tain the control block table. If the table ii con- 
tained in a stack, i.e. in the PXFILE area, then this is 
the DST nunber of the stack and not 0. 



File Systtn 

C8TPM 

CBTSUE 

CBTTYPE 



This is the PIN nunber of the process that has the control 
block locked. 

This is the size in uords of the table. It ii in- 
itialized Hhen the table is created and changed when the 
table is expanded, fit present a table is never contrac- 
ted, even though this is possible. 



This field is the 
Possible values art: 



type of the control block table. 



- stack [PXFILE] 

1 - HOBUF (expandable) 

2 - Syeten shared FCB 

3 - Buffered (Contains a single PACB) 

This ie the size, in uords, of the vector table area in the 
control block table. It does not reflect the nunber of 
entries used or unused. 

NOTE: All PIN's are kept as the uord offset into the PCB table and as the 
actual PIN nunber. 



CBTVTSI2E 



CBTLOCKBIT 



C8TQUEUE 



If the entire control block table is locked, then this bit 
is set. No locking count is kept since control blocks are 
locked only ones fron FCREATECB and FOELETECB uhen control 
blocks are added to and deleted fron the table. The proce- 
dure LOCK'CB does not lock the control block because it runs 
PSEUOODISABLED during the critical tines. 

Thie is the inpeded queue for the table and has the sane 
fornat as the inpeded queue For a control block in the 
table. There is no second inpeded queue because that 
facility is used exclusively for BREAK requests against 
the PAC8 for SSTDIN/»STDUST. 
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Vector Table 



The part labeled Vector Table contains infomation used to locate and lock 
or unlock control blocks in the control block table. 

The overall structure of the vector table is: 



ENTRY 



(FIXED, I UORDS) 



(FIXED) 



uhsre N « (CBTV1SIZE/«)-1. 

An unused vector table entry uill have zeros in all the uords of ths 
entry. A used vector table entry uill have a nonzero value in the first 
uord of the entry (the control block address is necessarily nonzero). 

The general structure of a vector table entry is: 

1 2 3 4 5 S 7 S 9 10 11 12 13 14 15 

I CONTROL BLOCK ADDRESS I VT'AOR 

| 1 

I L| B| COUNT | UNUSED I 1 VT'CONTROL 

j 1 

I LOCK PIN | 2 VT'PIN 

I HI6H PRIORITY HEAD PIN I 3 VT'QHEAO 

j 1 

I HIGH PRIORITV TAIL PIN I 4 VT'QTAIL 

j 1 

I LOU PRIORITV HEAD PIN | 5 VT'SAVEOHEAO 

| | 

I LOU PRIORITY TAIL PIN I 6 VT'SAVEDTAIL 

I I 

I UNUSED | 7 

I I 
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The following partial uord identifiers are i 

VT'LOCK'BIT ■ VT'CONTROL. (0:1) 
VT'BREM'BIT • VT'CONTROL. (1:1) 
VT'COONT ■ VT'COHTROL.(2:6) 



Control block address is the table relative address of the 

control block associated uith the vector table entry. 
It is a uord displacenent fron the beginning of the control 
block table. 

This bit signifies that ue »n in the niddle of break node. 
This is used for the PACB of fSTDIn/SSTDLIST fron a terninal 
session only. 

This bit is set whenever the control block is locked. 

This is the count of the nunber of tines that the control 
block has been locked by the process identified in VT'PIN. 
If it is zero, then the control block is not locked. 

Contains the PIN of the process uhich has exclusive ac- 
cess to the control block. Other processes at- 
tempting to access the block uill be inpeded and 



VT'PDI 



VT'OUEut The high priority inpeded queue is a double uord of PIHa 

that irt the head and tail of the inpeded queue of processes 
uaiting for access to the control block. Processes are 
inpeded and uninpeded by the file syeten using the hornal 
nechanisns available under APE. 

VT'SAVEOQUEUE The lou priority inpeded queue is a double uord of PINs 
and has the sane fornat w VTQUEUE. The only tine this uord 
is used is uhen the control block is in BREAK node, 
uhich can only happen to an RCB corresponding to 
ISTDIN/tSTOUST. It is used to save the current 
VT'OUEUE uhen the control block goes into BREAK node and to 
restore VT'OUEut uhen the control block goes back into 
non-BREAK node. 

NOTE: All PIN'S are stored as offsets within the PCB table and not as actual 
PIN nunber*. 
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Control Block Area 



The part labeled CONTROL SLOCK BREB contains the control blocks used by the 
file systen. 

To facilitate storage nanagenent, all control blocks have the sane 
overall structure: 




where N - Size-1. 

Partial uord field identifiers are: 



CBTYPE 
C8SI2E 



• CB. (0:2)*, 
■■ CB.(2:14)«; 



control block type nunber. 
control block size 



CBDESCRIP This is the first uord of a control block; the fomat is 
connon for all control blocks. 

CBSIZE This is the size (in uords) of the control block. The size 
includes the descriptor uord. 

CBTYPE This is the type nunber of the control block. There are 
four types of control blocks: 

- Garbage 1 - FCB 2 - PBCB 3 - LBCB 

Uhen a control block table is created the initial control block area is con- 
pletely allocated to a single control block of type garbage. Uhen space is 
requested for a new control block the control block area is scanned (using a 
first fit algorithm) for a garbage control block that is as large as the size 
requested. The space for the neu control block is taken fron this garbage 
control block and the space remaining becones the neu garbage control block 
size. 
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Logical Access Control Block (LBCB) 

Rll LfiCBs have the sane structure: 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
1*3 I 



OWLETS LACB SIZE 



FILE N0H8ER 



FILE NAHE - 1ST CHAR. 



FILE NAI1E - 2M0 CHRR. 



FILE NAHE - 3RD CHAR. 



FILE KflBE - 4TH CHBR. 



I 
-I 

I 1 



I 2 
-I 
I 3 



FILE NflUE - 5TH CHRR. 
FILE NBI1E - 7TH CHRR. 



FILE NAHE - 6TH CHBR. 



FILE HflhE - 8TH CHBR. 



I 4 
-I 
I 5 



I 6 
-I 



RECORD SIZE IN BYTES 



BLOCK SIZE IN UORDS 
SPARE 



I 10 
-I 
I 11 



i 12 



CRRRIRGE CONTROL CODE 



— I 



| lEOflPG- ILH 1ST |FK 1TC |T8 188 ICRRID8 I EOF T I EOF n I I 14 
|- 1 

| C| I TE| IC| I I TERHINAL STOP CHARACTER I 15 



ERROR COOE 
LAST I/O TRANSniSSION LOG 



I 16 
-I 
I 17 



Partial uord field identifiers are: 



LAC8SIZE 
LACBSTOPCHAR 



LACB. (2:14)11, size in uords 
■ LACB(2).(0:S)#, terminal stop character 



Discussion: 

LBCBROPTIONS See BCBAOPTIONS. 

LHCBBSIZE See ACBBSIZE. 
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Uhen space is returned it becones a neu garbage control block. To reduce 
fragnentation the neu garbage control block is conbined uith either of the 
tuo neighboring control blocks if they are of type garbage. 

If space is requested and no garbage control block is large enough to contain 
the neu control block then the control block area and control block table are 
expanded by a sufficient anount. If expansion it not possible, tone other 
control block table nust be used. 



Recess Control Block (RC8) 

Virtually every file systen intrinsic constructs an RC6 as its first action. 
Uhen using the nulti-aceess option, each accessor shares a single PACB. 
Houever each accessor is pemitted to vieu the shared file in a slightly dif- 
ferent nanner than the other acceseors. For exanple, one accessor nay access 
the file in a read-only node uhile the other accessor* nay access the File in 
a read-write node. To do this, each accessor nust, during his access, have a 
slightly different BCB. 

The PBCB holds information that is global to all acceseors of the file. The 
LBCB holds information that is local to each accessor of the file. Rt the 
beginning of a particular access, an BCB is constructed by calling LOC'BCB, 
uhich copies information fron both the LACB and the PACB. At the end of the 
access, the BCB is released by calling ONLOC'ACB; this updates the PBCB and 
LBCB fron the BCB since some of the fields nay have been modified due to the 
access. This schene nearly elininates EXCHANGEDB's to access the various data 
segments. 
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LACBCTL 

LAC8ERR0R 

LBCBFNlin 

LACBFOPTIONS 

LRCBI10DE 

LACBNBHE1-S 

LBCBPBCB 

LflCBRSIZE 
LACBSIZE 

LAC8STBTE 

LACBSTOPCHAR 

LRCBTLOG 



See ACBCTL. 

See ACBERROR. 

See ACBFHW1. 

See BCBFOPTIONS. 

See RCSOOOE. 

See HC8NBHE. 

This is the DST and vector table entry for the 
Physical BCB (PACB) for the file, 
file. 

See AC8RSIZE. 

This is the size, in uords, of the LACB. All LACBs are 
eighteen (decinal) uords long. 

See AC8LSTRTE. 

See BC8ST0PCHBR. 

See BCBTLOG. 
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Phvtictl torn CMltnil Blatk KHVI)} 
The ovtrall ttructurt of tht PACB it: 



I 



BASIC PACB 



BUFFERING 
EXTENSION 



(FIXED) 



(VARIABLE) 



Tht buffering extenaion it optional; it it preatnt if end only if the file 
u acceetcd Mith buffering. There are thus tuo potiiblt fornatt for <n 

1. No bufftrti the bufferins extenaion it not preeent. 

2. MCB bufftrti the buffering txtention it present and the buf- 
ftn art in tht buffering txttntion. 

If nultiple MCB buff en exitt, there uill be a buf ferine extension for 
each, innediately preceding tht bufftr. The batic MCB (or N08UF MCB) it 
copied into the tht BCB at uordt through 163; an BCB "txttntion" it then 
generated in uordt X64 - 167. The reaulting BCB thut hat tht follouing 
Fomat: 
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26 
27 
2> 

29 
30 
31 PF |WT| 

32 



33 
34 
35 
36 
37 
39 
39 
40 
41 
42 
43 
44 
45 
4S 
47 
48 
49 
50 
51 



TOTAL NUtlBER OF LFCB'S 



IBK I 



DEVICE TYPE 



I LAST LOGICAL I/O STATUS 



LOGICAL DEVICE NUKC 



I CURRENT BUFFER | TAPE DISPLACE I NO. BUFFERS 



CURRENT RECORD UORO INDEX 



BUFFER SUE 



VIRTUAL LOGICAL DEVICE NO. 



FBHVT INDEX 



NWBER OF INPUT LACB': 



FILE DISPOSITION 



I 



BLOCKING FACTOR 



S I n | g I R | D | 
SPOOLED DEVICE TYPE | 



I AEI RUIABRI NE| SEOFSI EOFS 



SPOOLED DEVICE RECORD SIZE 



SPOOLED DEVICE FOPTIOKS 



SPOOLED DEVICE AOPTIONS 



IDO OR ODD INDEX 



NO-UAIT DISK AOORESS 



Filt Sytten 

32 

33 

34 

35 

36 

37 

40 

41 

42 

43 

44 

45 

46 

47 

50 

51 

52 

S3 

54 



UNUSED 



NO-UAIT LOGICAL DEVICE 

P1P2 USEO BY FOEVICECOHTROL 
UNUSED 



UNUSED 



56 
57 
60 

i 61 
-I 

I 62 
-I 

I 63 
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1 2 3 4 5 6 7 » 


9 10 11 12 13 14 15 


2 I COhTLETE ACS SI2E 


I FILE NUHBER | 


FILE NAME - 1ST CHAR. | 


FILE NAME - 2ND CHAR. | 


FILE NRflE - 3*0 CHAR. | 


FILE NrHIE - 4TH CHAR. 


FILE NATE - 5TH CHAR. | 


FILE NANE - 6TH CHAR. 


FILE HARE - 7TH CHAR. | 


FILE NRflE - STH CHAR. 


FOPTIONS 


AOPTIONS 


Record tize in 


bytet 


BLOCK SIZE IN UORDS 


UNUSED 
.—at.......... ——__-„__„ 




CARRIAGE CONTROL CODE 


IEOFIPG UN 1ST |FK |TC |TB IBS |CAR|DB 1 EOF T | EOF 11 I 


CI 1 TE| ICI | | TERHWN. STOP CHARACTER 


ERROR CODE 


LAST I/O TRANSMISSION L06 



FILE POINTER 



CURRENT VARIABLE BLOCK NUIBER 



RECORD TRANSFER COUNT 



BLOCK TRANSFER COUNT 



HIGHEST BLOCK NUIBER STARTED 




1 
2 
3 
4 
5 
6 
7 
10 
11 

12 

13 

14 

15 

16 

17 

20 

21 

22 

23 

24 

25 

26 

27 

30 

31 
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The ebovt uordt, 0-«3, art phytically located in tht MCB of tht filt. 
Belou, uordt 164-167, art uted by filt tytttn intrintict- and art placid 
onto tht ttack by the procedure LDC'ACB uhen locking the ACB. 
Therefore, the buffering txtention, if pret- ent, uill innediattly fol- 
lou uord Z63 of the actual ACB in the Control Block Table of tht file. 



I 

52 I 
I 

53 I 
I 

54 I 
I 

55 I 



DST RELATIVE OFFSET TO PACB 


DST RELATIVE OFFSET TO LACS 


DST RELATIVE OFFSET TO ACB IN THE 


STACK 


STACK RELATIVE OFFSET TO DB 





Tht follouing identifitrt are uted uhen referring to an ACB: 



(AC8SIZE) 

dCBFHUI 

ACBNAflE 

ACBNHNE1 

ACBNBBH 

ACBFOPTIDNS 

AC8M0PTI0NS 

HC8RSIZE 

AC88SIZE 

Spare 

ACBCTL 

ACBLSTBTE 

ACBEOF 

ACBLPCTL 

BCBPBOECTL 

ACBLIHECTL 

ACBSTREAn 

ACBfKEYS 

ACBXnlTCRLF 

ACBTBLOCK 

AC88INARYI0 

ACBCHRRIAGE 

(BCBDEFBLOCK) 

BC8RES0CODE . 

ACBREADTYPE 

ACBREADnODE 

ACBKODU 

ACBDODE 

ACBCIROVERFLOU' 

BCBSETHOOE 

BC6TBPEERR0R ■ 

ACBINHIBCRLF • 

BCBQUIESCE 



• AC6.(2:14)«, 

■ ACB(1).(8:S)», 

• ACB(2)«, 

• ACBDGL(1)«, 
« ACB08L(2)», 

• ACB(6)«, 

• RCB(7)», 
' At»(8)#, 

• ACB(9X, 
' ACBdOMI, 

■ AC8(11)», 

• AC8{12)«, 

■ ACBLSTATE.(1:1)#, 

• BCBLSTATE. (2:2)1, 
' AC8LSTATE.(2:1)», 
' ACBLSTBTE. (3:1)4, 
= ACBLSTBTE. (4:1)11, 
= ACBISTATE.(5:1)», 

■ ACBLSTBTE. (6: 1)», 
= ACBLSTATE.(7:1)«, 
" AC8LSTATE.(8:1)B, 

■ ACBLSTBTE.(9:1HI, 

■ ACBLSTBTE. (10:1)», 
' ACBLSTBTE. <11:4)», 

■ AC8LSTHTE.<11:2)«, 
= BC8LSTBTE.(13:2)#j 

■ ACB(13)«, 

■ ACBflODU.(0:8)«, 

■ BCBnODy.(0:1)«, 
' AC8B0OU. (4:4)11, 
' ACBffi)0U.(4:1)lt, 

■ BC6N0OU.(S:1)», 
> flCBnOOU.(E:1)«, 

• qCB'Wll, («:«;*, 



tize in uordt 

file nunber 

file nana 

filt nam - firtt half 

filt next - tecond half 

FOPTIONS 

AOPTIONS 

record tin (bytet) 

block tize (uordt) 

United 

carriage control uord 

local ttate flagt 

end of file tented 

page and line control 

page control 

line control 

etrean I/O 

rettore function keyt 

trantnit CR,LF to uter 

ditablt block node 

8-bit teminal trantfert 

carnage control flag 

default blocking 

input EOF check 

input EOF type 

input EOF node 

node uord 

node tttting 

Signifiet CIR overflou 

FSETHODE bitl 

report recovered tape error 

inhibit teminal CR/LF 

critical output verify 

terminal stop character 
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mam 


« BCB(l4)», 


SCSTLOS 


= fiCS(15)», 


BCBFPTR 


• RCBHUOt)*, 


ACBBLK 


• RCBDBK09 «, 


SCBRTFRCT 


• BC6DBL(10)», 


BCBBTFRCT 


» AUDBL(11)«, 


BCBH18LK 


■ RCBDBU1Z)*, 


BCSFCBV 


' RCBDBH 13)11, 


BCBSHCNT 


= BCB(28)«, 


BCBSTATU 


- BC.B(Zm 


RCBBREHK 


> ACBSTATU,(1:1)B, 


BC8DTYPE 


« BC8STflTU.(2:61«, 


BCBBKCL 


» BCBSTBTU..(2:3)», 


SCBSU8CL 


• BtBSTflTM.(5;3)B, 


RCBSTATUS 


. BCBSTflIU.(S:!)t, 


BCBQSTfiTUS 


• BCBSTRTU.(8:5)«, 


RCBGSTBTUS 


= BCBSTATU. (13:3)«, 


BCBDBDDR 


■ BCB(»)», 


RCB3UFK 


■ RCB(31)», 


BCBPRIV 


* BCB6UFX.(0:1)«, 


BCBHIT 


= BCSBUFX.(1:1)«, 


BCBCURRBUF 


• SCBBUFX.[4:4)(t, 


BCBHgTIBUFS 


« Rr.BSUFX.(12:4)B, 


BCB6UFUSE0 


= BC6(32)«, 


RCBBUFSIZE 


« BC8(33)#, 


BCBSPVDEV 


« ACB(34)#, 


BCBFHAVTX 


= BC8(35)«, 


RCBSHCNTIN 


= BC8(36)«, 


ACBDNTD 


= BCB(37)», 


BCBONTYPE 


■ BCBDNTD. (0:8)11, 


BC8DISP 


= BCBDNTD. (8:8)11, 


flCBBIILD 


= BCB(38)», 


BCBBCCESS 


= BC8RI1L0. (0:8)11, 


RCBBLKFBCT 


= flCBBIILD. (8:8)#, 


OCBGSTU 


= BCB(39)», 


RCBSPOOLED 


= ACBGSTU. (0:1)*, 


BCBSPOOLIO 


= BC8GSTU.(0:2)», 


BCBSPSO 


= BC8GSTU.(2:2)*i, 


scsspsqz 


= BCBGSTU.(2:1)», 


BC8SPRSQ 


= BCBGSTU.(3:1)», 


BCBSPOSO, 


• ACBGSTU. (4: 1)«, 


RCBNOUAITEOF 


= 8CBGSTU.(8:1)», 


BCBNOUBITHOOE = ACBGSTU. (9:1)11, 


BCBBBORTREBD 


= RCBCSTU.(10:1)H, 


BCBMEUEOF 


= BCBGST1I.(11:1)», 


BCBSBVEEOFS 


= RCBGSTU.(12:2)#, 


BCBEOFS 


= BCBGSTU.(14:2)», 


RCBSPTYRC 


= BCB(40)», 


BCBSPTYPE 


= BC8SPTYRC.(0:6)», 


BC8SPREC 


= RCBSPTYRC. (6:10)» 


BCBSPFOPT 


■ BCB (41)11, 


BCBSPBOPT 


= BCB(42)«, 


ACBSPXDDJ! 


= RCB(43)», 


BC8N0UHITDB 


» BCBDBL(22)#, 



error code 

list I/O trantnission Its 
currant reeord nunber 
current variable block 
logical record TFR count 
block transfer count 
highest block itarttd 
FC8 Vector table entry 
It of LfiCSs 

kiii dm, status, itc. 
bruk (MTOM/LIST only) 
device type 
devici access dais 
device sub-das* 
l»t logicil I/O status 
qualifying ttatut pirt 
general itatui part 
Ldev nunber of file 
buffer data i. nisc. fltgi 
privileged access only 
buffer hit flag 
current buffer nor. 
nunber of buffiri lite 1 
used block uord count 
buffer size (uorde) 
spooled virtuil device 
FflflVT index 
Nunber of input LBCB's 
type & disposition 
nine type for dir. search 
file disposition 
access nask & LDEV 
access nask 

Blocking factor of file 
spool control flags 
spooled device flag 
spooled IN/BUT 
squeeze flags 
file squeezed 
request to squeeze 
squeeze just done 
EOF advanced? 
last I/O: 0=read, 1=urite 
abort broken re-read? 
EOF advanced - tape file 
for saving BCBEOFS 
EOF flags - :E0D/: 
spooled dev type/recsize 
spooled dev type 
spooled dev rec size 
spooled dev FOPTIOHS 
spooled dev BOPTIONS 
IDD/ODO index 
Nouait disc address 



Fill Syltin 



Spare • BCB(46)», 

KUUUUTIDEV « BCB(47)», 
BC6F1P2 • BCBBBL(24)B, 

BCSB1 • BM(4«)», 

RCBP2 = flCB(49)B; 



Unused 

Houait logical devici 

Used bv FDEVICECONTROL 



Discussion: 
RC6RB0RTREBD 
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BC8BSI2E 
BCBBTFRCT 

RCBBUFUSED 



File Systen 



This is the break node flag. It is applicable if the BCB 
is for ISTDIN or MIDLIST. If set it neans that the 
BREAK key has been hit and that the CI should have high 
priority access to the BCB. The flag uill be cleared 
uhen a RESUME or RBOBT is issued. 

This is the block size, in uorde, of the file. 

This is the total nunber of blocks transferred to and fron 
the file. The initial value is OD. 

of the 
This is 



BCBCTL 



BCBCURRBUF 



This is the word index, relative to the base 
block, for the selected record uithin the block, 
applicable if the File access is buffered. 

This bit signifies that the file has carriage control. It 
is the sane as the carriage control bit in 
flCBFOPTIONS if the file is spooled. If not spooled, the 
bit is zero, and IOIIOVE uill pass the FURITE carriage 
control paraneter directly to the driver rather than 
enbedding it as the first character of the output record. 

This is the CONTROL paraneter fron the last FURITE. 
This value is pertinent if the file uas opened uith car- 
riage control. 

This is the buffer nunber (O-relative) containing the nost 
recently referenced record. Applicable if the file access 
is buffered. 

This is the logical device nunber of the file. For a disc 
file this is the logical device nunber of the first 

extent. 

This bit signifies that the file is to be accessed uith 
default blocking. The bit is initialized fron the 
FOPEN stateuord STBTE. It does not need to be in the RCBi 
it is nentioned here only to signify that the bit is effec- 
tively used due to the uay BCBLSTBTE is initialized 
fron STBTE. 

This is the file close disposition derived fron the 

FOPEN call. The only uay this can be specified is via a 

file equation. The legal values are the sane as those 

for FCLOSE. 



RCBBCCESS 



Thii flag is used to abort a broken teminal ii-riad. The 
flag is set via the ABORT paraniter to FUN8REBK. IF thi 
flag ii set thin the BEAD PENDING nessage uill bi aborted 
along uith thi re-read. This feature ii meded to hand- 
le the BREAK... : ABORT, etc. situation. 

This is the aceisi class part of the devici type nun- 
bir. The following are legal values: 

- direct (e.g. disc) 

1 - serial input (e.g. card reader) 

2 - parallel input/output (e.g. teminal) 

3 - serial input/output (e.g. nagnetic tape) 

4 - serial output (e.g. lim printer) 

This is the access bit nap for the file. The follouing are 
the bit definitions of this eight-bit field: 

(0:1) - unused 
(1:1) - unused 
(2:1) - read 



(3:1) • 

(4:1) ■ 

(5:1) • 

(6:1) • 

(7:1) • 



append 

urite 

lock 

execute 

save 



ACBBOPTIONS 

BCBBINBRYIO 



BCBBLK 



ACBBLKFBCT 



This access security is deternined by the RCCCHECK in- 
trinsic and enforced by the file systen. 

This is the BOPTIOHS in effect for this file access. 

This bit controls full eight bit transfers on the 2644 page 
node teminal. It is adjusted by FC0NTR0U26) and 
FC0NTROU27). 

This is the block nunber of the current variable record for- 
nat block. Applicable if the record fomat is 
variable. 

This is the blocking factor for the file. It is the nun- 
ber of records in a block. Legal values range fron 1 to 
255. 
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File Systen 
BCBDHTYPE 



This is the file reference fomat type nunber and is 
derived fron the FOPEN call. The follouing are legal 
values: 

- fuli nane 

1 - account nane absent 

2 - group and account nane absent 

3 - null nane 

This infomation is needed by FRENflBE. 



BCBDTYPE 



of the file. The fol- 



BCBEOF 
BCBEOFS 



ACBERROR 



BCBFCB 
BCBFKEYS 



This is the device type nunber 
louing are legal values (octal): 

- noving head disc 

1 - fixed head disc 
7 - foreign disc 

10 - card reader 

11 - paper tape reader 
20 - teminal 

24 - card reader/interpreter/punch 

26 - SSLC 

27 - progrannable controller 

30 - nagnetic tape 

31 - serial disc 

40 - line printer 

41 - card punch 

42 - paper tape punch 

43 - CALCOHP 600 plotter 

44 - CRLC011P 600 plotter 

45 - CfllCOflP 700 plotter 

This bit is set uhen EOF has been sensed. 

This is the type of EOF detected on SSTDIN(X). This 
field consists of tuo bits: 

(0:1) - super colon (i.e. EOF for ISTDINX) 
(1:1) - regular colon (i.e. EOF for tSTDIN) 

Applicable for nulti-access to »STDIN(X) only. 

This is the error nunber for the file. It is used by all 
intrinsics except FOPEN. Uhen an error is detected the er- 
ror nunber is placed in this cell. The error nunber is 
cleared at the beginning of each callable intrinsic except 
FCHECK (uhich reads it). 

This is the FCB vector for the file, 
disc files. 

This bit controls the definition of the f1 and f2 
function keys on the 2644 page node teminal; it is 
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Applicable only to 



RCBFOPTIONS 
RC8FPTR 



RCBFhWTX 



BtBGSTATE 



ACBGSTATUS 



AC8HIBLK 



ACBHIT 



SCBHHIBCRLf 



ACBUNECTL 



File Systtti 

adjusted by FCO»TML(M) end FC0RTR0K33). (Obsolete 
function) 

File nunber, range fron 1 to 255. Uwd nottly for 
calling routines that access things such at labtlt by filt 
nunber. 

rhii ia tht FOPTIONS in affect for thit filt accett. 

Thit it tht acquantial accttt record pointtr; it con- 
taint tht ntxt sequential record nunbtr. Tht initial 
value it OD. Thit value it used only by tht FREUD, FURITE 
and FUPDATE intrinsic*. However the value i» Main- 
tained by all data trantftrring filt tytten intrintica. 

Thit it the entry index into the file nulti-accett vec- 
tor table (FhmVT). Thit ia valid if the file accett 
it nulti-accett. 

Thete are nitcellaneoua ttate flast. Thete are 
"global" in nature in that they are the taut for all ac- 

ctttora in a nulti-accett environment. Tht con- 
ttituent bitt are described individually. 

Thit it the general part of the last I/O ttatut for the 
file. The following are the legal valuet: 

- pending 

1 - tuccetsful 

2 - end of filt 

3 - unusual condition 

4 - irrecoverable error 

Thit it the highest block nunber for uhich an an- 
ticipatory read has been issued, and is applicable if the 
file accett it buffered. The initial value is -1D. 

This is the buffer hit flag. If set it indicate! that the 
latt read or urite request uat serviced uithout any physical 
I/O required. Thie flag ia used only for perfomance 
neasurenent. The code uhich Manipulates it it optional to 
tht filt system, and is controlled by compiler toggle K3. 

Thit bit controli the termination of lines uritten to the 
terminal. If not set then each line is terminated uith a CR 
and LFj if set then no line termination characters *n 
need. Thit bit is valid if the file it a terainal file: it 
it adjusted by FSETHWE . 

Thit it tht line control bit. If not ttt then each line 
it post-spaced; if set then each line it pretpaced. 
This bit is used by line printers and terminals only. 
It is adjusted by FCOHTROld) and FURITE uith the 
appropriate carriage control. 
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nTBREAOCOOE 
flCBREROnWE 

RC8REA0TYPE 

BCB8SIZE 
RCBRTFRCT 

AC8SAVEE0FS 

AC8SHCHT 

HCBSHCNTIN 

RC8SHCNTS 
HCBSKE 

ACBSPWT 
RCBSPFOPT 
RCBSPOOLEO 
flCeSPOOUD 



File Sytten 

device uhen control it returned to the ueer. Thit bit is 
adjusted by FSETH00E. 

Thit field comitti of the input EOF checking type and 
JS^,..." - . " mi t0 9*>erate the PI paraneter to 
RTTACHIO. Thete fields are described individually. 

This field controls the input EOF checking node. It it 00 
for reading tSTDIK, 01 for reading ISTDIIB, and 10 for the 
command interpreter. 

Thie field controls the input EOF checking type. It ia 01 
for JOBs, 10 for SESSIONS, wl 00 for DATA? 

This is the file's record tilt in positive bytes. 

This is the total nunber of records transferred to and fron 
the file. The initial value ie 00. 



contents of RCBEOFS 



This field is used to save the 
during BREAK mode processing. 

This it the total number of LACBt that exist for this 
PACB. Valid if the file accett it nulti-acctts. 

Thit it the total number of input-only LACBt that exiat for 
thie PRCB. Valid if the file access is 

multi-access. 

This it tht total LACB and total input-only LAC8 
countt, each of uhich it described separately. 

Thit it the size, in uordt, of tht ACS. Tht complete 
tizt (including buffers) nay be calculated fron the OST size 
containing the BBC. It does not include the buffering ex- 
tension, if present. 

Thie is the ROPTIOAS for the spooled device. 
Applicable if the file access it to a spooled device. 

Thit it the FOPTIORS for the spooled device. 
Applicable if the file access is to a spooled device. 

Thit is tht spooled device flag. If tet then the file ac- 
cess it to a spooled device. 

This field is a combination of the spooled device flag and 
the input/output node of the spooled device. Legal values 
are: 



00 • 

01 • 
10 ■ 



not spooled 
illegal 
input spooling 

?'.'*•".'+ spooling 
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HCMKTL 

ACBLSTATE 

AcanooE 

ACBNEUEOF 
KBNOURITEOF 

AteWWITMOE 

ACBNtRBUFS 
ACBWGECTL 



Thit art tht line and 
described separately. 



page control bits, uhich are 



These are miscellaneous state flags. They are "local" in 
nature in that they may be different for each acces- 
sor in a multi-access environment. Bits (9:6) are initial- 
ized fron the stateuord local variable called STRTE in 
FOPEH; the ten renaming bitt are initialized individually. 
The constituent bits are described individually. 



The constituent bits 



These art miscellaneous node flags. 
are described individually. 

This is the local filt name. The name it tight byttt in 
length uith trailing blanks added. 

This flag uhen set indicates that a neu tape nark 
should be uritten before the tape it reuound or 
backspaced. Applicable only to magnetic tape files. 

Thit bit is used to save the value of the local EOF ad- 
vanced flag KEUEOF in IOIIOVE betueen the I/O initiation and 
I/O completion calls. Thit flag is applicable if the 
file is accessed in nouait I/O node. 

Thie ctll is used to save the I/O node betueen nouait I/O 
initiation and completion calls. If the bit it tet then tht 
last I/O request uat a urite; otherwise it uas a read. 
This cell is pertinent if the file it accessed in 

nouait I/O node. 

This is the nunber of buffers, less one, used for the file 
access. Applicable if the file accett is buffered. 

Thit is the page control bit. If not tet then a page it 
assumed to consist of 60 lines (auto page eject); if set 
then a page is assuned to consist of 66 lines (no auto page 
eject). This is used primarily for line printers but 
is alto valid for ttrninalt; thete are the only devices for 
uhich this is valid. This bit is adjusted by 
FCOHTROL(I) and FURITE uith the appropriate carriage 
control. 

ACBPRW Thit flag uhen ttt indicates that the file is 

privileged in that it has a negative file code; the uter 
must be in privileged mode to access it. 

This it the qualifying part of the latt I/O status for the 
file. The valuet are unique for each general status 
part. See I/O Sytten IBS for all legal values. 

AC80UIESCE Thit bit controli critical output verification. If set, 

buffered output it guaranteed to have been uritten to the 
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RCBQSTATUS 



File Sytten 

RCBSPREC 

ACBSPTYPE 

ACBSPTYRC 
ACBSFVDEV 

ACBSPKODH 

ACBSTRTUS 



nCBSUBCL 



Thit it tht record tizt, in byttt, of tht spooled 
device. Applicable if the file accett it to a spooled 
device. 

Thit it tht device type (fron the IDT) of the spooled 
device. Applicable if the file accett it to a spooled 
device. 

Thit ctll conteint tht spooled device type and record 
size, uhich art described separately. 

Thit it tht logical device nunber of the spooled 
device. Applicable if the file accett is to a spooled 
device. 

Thit it the index into the 100 or 000 for , tpoolfile. 
Applicable if the file access it to either a spooled 
device or a tpoolfile. 

This is the last I/O status for the file. It cones from 
the I/O status part of the I0CB returned by ATTRCHIO. 
Hot all RTTACHIO calls update this cell. 

Thit it the record termination character uttd for ter- 

nmnSSn. Th " c>arKt " Mn "* ""^ v " 

Thit bit tignifies inter-block garbage for di«c files If 
set, the block size it a Multiple of 128 uordt and there- 
fore there it no garbage data betueen block*. Thit 
fact it used to inprove nultirecord I/O by naopinq 
the request into at feu RTTflCHIOs as poetibie. 

Thie is the tub-clat* part of the device type nunber. The 
tub-class is unique for each access class. The follow- 
ing are the legal tub-class valuet for each device 
class: 

- direct 

- Moving head disc 

1 - fixed head disc 
7 - foreign disc 

1 - serial input 

- card reader 

1 - paper tape reader 

2 - parallel input/output 

- terninal 

4 - card reader/punch 

6 - SSLC 

7 - programmable controller 

3 - serial input/output 

- nagnetic tape 
7 - serial disc 

4 - serial output 
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lint printer 
Mrd punch 
paper tape punch 
CBLCOilP 503 plotter 
CHLCOHP 600 plotter 

caixunp w plotter 



ACBTAPEERROR 



HCBTBLDCK 



This bit controls the reporting of recovered nagnetie er- 
ror>. If not »«t the recovered errors ere not 
reported to the user; if set then recovered errors are 
reported to the user by returning CCL and error nunber 39. 
Valid if the file is a nagnetie tape file. This bit is 
adjusted by FSETMODE. 

This bit controls block node transfers on the 2644 page node 
ttrninal. This bit is adjusted by FC0NTROL128) and 
FC0NTR0L(29). 

This is the last I/O transnission log for the file. It con- 
es fron the I/O transnission log part of the IOCB return- 
ed by ATTACKIO. Hot all BTTHCHIO calls update this cell. 

This is the volune table index for the file. 
Applicable if the file is a disc file. 

RCBXHITCRLF This bit controls CR and LF insertion into the user 

buffer on the 2644 page node teminal. This bit is ad- 
justed by FCONTROL(M) and FC0NTR0LO1). 



ACBTLOG 



RCBVDBOOR 
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If present, the PAC8 buffering extension contains fron one to sixteen 
block buffers each having the following fomat: 



1 2 3 4 S 6 7 3 9 10 11 12 13 14 15 
-I--I-I-IH--I--I--I--I--I--I--I--M--I--I 

100 ENTRY INDEX | BLKIOOX 
1 

BLK LOEV NUHBER I I I Ul R| 0| U| n| PI 1 6LVLA6U 

IOCB - STATUS I 2 BLKLSTRT 
1 

IOCB - TRANSMISSION LOO I 3 BLKTLDO 
( 

I 4 BLKBLOCK 
BLOCK NUHBER 

I 5 
1 

I 6 BLKDRDOR 
BLOCK SECTOR ADDRESS [ 

I 7 
1 

I 8 BLKEXTBRSE 
BLOCK EXTENT BASE i 

I 9 
1 

BLOCK EXTENT SIZE i 10 BLKEXTSIZE 
1 

UNUSED | 11 
1 

I 12 BLKBUFFER 
I 
I 
BUFFER | 
I 
I 
I 
1 



Other identifiers used: 



BLKFLAGU 

BLKLDEV 

BLKFLAOS 

BLKUNBLLOCEXT 

BLKREVERSE 

BLKDONTURIT 

BLKIOOUT 

BLKDIRTY 

BLKIOPEND 

BLKIOCOnP 

BLKIOCB 



= BLK(1)tt, 
= BLKFLAGU. (0:8)*, 
= BLKFLAGU. (0:8)#, 
= BLKFLHSU. (10:1), 
= BLKFLRBI.(11:1), 
= BLKFLBSU.(12:1), 
= BLKFLRGU.(13:1)lt. 
= BLKFLRGU.(14:1)«, 
= BLKFLBGU.(1S:1)«, 
= BLKFLBGU.(14:2)« ( 
= 8LK0BL(1)», 



Flag and LDEV uord 

block logical device nunber 

block I/O flags 

Block fron unalloc. extent 

FREflDBRCKUARD (not used ) 

I/O status not checked 

last I/O uas urite? 

buffer nodified? 

I/O in progress? 

I/O conplete - not dirty 

IOCB 
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Discussion: 
8LKBL0CK 

BLKBUFFER 

BLKDADDR 
BLKDIRTV 



8LKEXTBRSE 
BLKEXTSIZE 

BLKFLRGS 
BLKIOCB 

BLKIOCOnP 

BLKIOOUT 
BLKIOPEND 
BLKIOOX 

BLKLDEV 



File Systen 



This is the block nunber oF the data contained in the 
buffer. A value of -10 indicates that the buffer is 
enpty. 

This is the actual file systen buffer space. Each buffer is 
exactly one file block in size. 

This is the block's logical device and sector nunber. 

This flag is set if the contents of the buffer has been 
nodified. Uhen the block buffer is re-used this flag is 
checked to see if the block needs to be written to the 
device. 

This bit uill be on if the I/O uas already conpleted via 
"DDNT'UAIT" but the status has not been checked yet. Check 
the status before using the block in the buffer. 



This is the sector address of the extent base in which the 
block resides. This is used for disc caching. 

The size, in sectors, of the extent in uhich the block 
resides. This is used for disc caching. 

These are the Miscellaneous flags associated uith the 
block, uhich »n described separately. 

This is the IOCB returned by the I/O systen uhen the 
block I/O has conpleted. On a blocked I/O request this is 
obtained fron the RTTACHIO call; on an unblocked I/O request 
this is obtained fron UAITFORIO. 

This is the buffer nodified flag (BLKDIRTV) and the I/O in 

progress flag (BLKIOPEND), which are described 

separately. This field is usually interrogated to see if 

it contains the value 2, uhich neans that the buffer has 
been nodified but not yet uritten to the device. 

This is the node of the I/O operation for the block. It 
is set by a urite and cleared by a read. 

This is the I/O in progress flag. It is set if the I/O is 
pending; it is cleared when the I/O has conpleted. 

This is the IOQ index of the unblocked I/O request for the 
block. It is used as the argunent to UAITFORIO, uhich en- 
sures the conpletion of the I/O request. 

This is the logical device nunber of the block. (Valid only 
for disc files. ) 
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BLKLSTBT The I/O status part of the IOCB consists of the PCB nun- 

ber and the error code for the conpleted I/O 
request. 

BLKTLOG The transnission log part of the IOCB is the nunber of 

words or bytes transferred by the the I/O request. 

BLKREVERSE This bit uould indicate that ue are reading back- uards fron 

a tape. Houever, currently FREAD6ACK- UARDS can only be 
perfomed unbuffered. 

BLKUNALLOCEXT This bit signifies that the block uas "read" fron an unallo- 
cated extent. Actually, the buffer uas sinply cleared uith 
fill characters. Therefore, if a write is attenpted to the 
block residing in this buffer, it nust pass through FCONVBLK 
to allocate the extent first. 
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File Control Blocli (FCB) 



The FC8 coordinates access to a file on a sharable device, fit present the 
only sharable device is a disc, so only disc files have FCBs. 

The information contained in an FCB is derived fron the file label. The FCB 
is used to hold this infomation, rather than the file label, since it can be 
accessed nore quickly. 

There are two strategies to choose fron in deciding uhere to place the FCB. 
If the file has been opened exclusive and no other process could possible 
•hare this file, then the FCB is placed into the PXFILE in* (or in a NOBUF 
expandable C8T if it uon't fit in the PXFILE »n» or if the progran is run 
uith NOCB). If the file could possible be shared, then the FCB is aluays 
placed in a shared control block table. The nuttber of a data segnent con- 
taining a list of shared file systen data segnents is kept in systen global 
location 1076 octal. The size of the FCB depends on the naxinun nunber of 
extents specified at FOPEN; there are 44 (octal) uords plus two per extent. 
There uill be at least one extent, since the file label aluays exists in the 
first extent. The FCB extent nap is in terns of logical device and sector 
nunber. The extent nap in the file label is in tems of volune rather than 
logical device; the nap is converted by VTR80LDEV uhen the label is read, and 
converted back by LDEVTOVTRB uhen the label is uritten to disc. 

The File Control Block has the follouing fontat: 



I 
I- 

1 I 



7 8 12 13 14 15 

COflPlETE FCB SIZE 

SPARE 



FOPTIONS 



DEVICE SPECIFICRTIOH 



2 I 
| 

3 I 
| 

4 | PREV. LOCKI OEV. TYPE I C 

5 I 



6 I 

I- 

7 I 



IDEVICE SUBTYPE 



Ml. OPENS FOP. OUTPUT 



HO. OPENS FOR ANY NODE 



RIN RUBBER 



> I 



9 I CI 



EXCLUSIVE STRTOS 



I iwtrbx | 



VtlflSK 



10 I 



11 I 
I- 



FIl£ win 



FCBf OP- 
TIONS 

FCBDEVICE 




1 
2 
3 
4 
5 
6 
7 FCBRIN 

10 FCBEXC- 
STAT 

11 FC6WINF0 

12 FCBFLM 

13 
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File Control Block (Cont. ) 
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UNUSED 



END OF DATR POINTER 



NO. USER LABELS URITTEN I NO. USER LABELS RVRTl. 



EXTENT SHE IN SECTORS 



BLOCKING FACTOR I SECTORS PER BLOCK 

SECTOR OFFSET TO DATA | DISP I NO. EXTENTS - 1 
LAST EXTENT SIZE IN SECTORS 



NO. OPENS INPUT NODE 
GROUP" KRflE - 1ST CHRR. I GROUP NOTE - 2ND CHRR. 



GROUP HRHE - 3RD CHRR. I GROUP NRflE - 4TH CHAR. I 27 



16 


FCBEOF 


17 




20 


FCBUSERLBL 


21 


FCBEXTSIZE 


22 




23 




24 
25 


FCBLAST- 
EXTSIZE 


26 


FCBGN 



-I 

GROUP NRflE - 5TH CHRR. | GROUP HRflE - 6TH CHRR. I » 



-I 
GROUP NRflE - 7TH CHRR. | GROUP HRflE - STH CHRR. I 31 



RCCT NRflE ■ 



-I 



1ST CHRR. | RCCT NRflE - 2ND CHRR. I 32 
1 

RCCT NRflE - 3RD CHRR. | RCCT NAPE - 4TH CHAR. I 33 



-I 
RCCT NRflE - 5TH CHRR. I RCCT NRflE - 6TH CHAR. I 34 



-I 



RCCT NRflE - 7TH CHAR. I RCCT NRflE - STH CHAR. I 35 
, 

I 36 

I 
I 37 



START OF FILE BLOCK NUtBER 



CURRENT NUflSER OF DRTR BLOCKS IN THE FILE 



-I 
I 40 FCBEND 

I 41 



34 I | 42 
I MMBER OF OPEN AND CLOSE RECORDS (ICSSRGE FILE) | 

35 I | 43 



FC9NUH- 
OPENCLSREC 



I- 



36 I LOGICRL DEVICE NUIIBER I 



I- 
37 I 



FIRST EXTENT SECTOR NUNBER 
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File Systen 



I LOGICRL DEVICE NUNBER 



File Systen 
FCBOEVICE 

FCBOISP 



LAST EXTENT SECTOR NUflBER 



Other identifiers used: 



FCBSIZE 


■ FCB. (2:14)11, 


size in uords 


FCBLKST 


= FCB(4).(0:2)», 


previous lock stats 


FCBOTYPE 


= FCB(4).(2:6)«, 


device type 


FCBCRUNCH 


■ F(B(4).(8:1)#, 


pending crunch disposition 


FCBSUBTYPE 


- FCB(4). (12:4)11, 


device subtype 


FCBOCNTOUT 


= FC8(5).(0:8)(t, 


no. ecceseors - output 


FCBOCNT 


= FCB(5).(8:8)#, 


no. accessors 


FCBCLASSFLG 


= FCB(9).(0:1)#, 


PV class flag 


FCBIWTRBX 


= FCB(9).(4:4)», 


ttounted volune table index 


FCBVflRSK 


• FCB(9).(8:8)», 


Volune flask 


FCBLBIEOF 


= FCB(16).(0:S)#, 


no. labels uritten 


FC6LBL 


■ FCB(16).(8:8)», 


no. labels available 


FC88LKFACT 


= FCB(18). (0:8)11, 


blocking factor 


FCBSECTPBLK 


' FCB(18).(8:S)», 


sectors per block 


FC8SECT0FF 


= FCB(19).(0:8)N, 


sector offset to data 


FCBDISP 


■ FCB(19).(8:3)», 


pending disposition 


FCBNUflEXTS 


= FC6(19). (11:5)11 


no. extents less 1 


FCBOCNTIN 


■ FC6(21).(8:8)». 


no. accessors - input 


FCBLRBEL 


' FCB0BL(18)N, 


label LDEV and sector 


FCBLDEV 


' FCB(3G).(0:8)N, 


label LDEV 


Discussion: 







FCBOTYPE 

FCBEND 

FCBCOF 



FCBEXCLSTflT 



FCBACBDST 



fCBPN 
FCBBlKFflCT 



This it the D3T of the KB that uas created at the sane 
tine as the FCB. This is used in conjunction uith 
FCBHEuFCBDST uhen relocating the FCB. 

This is the vector table entry of the RCB that uas 
created at the sane tine as the FCB. This is used in con- 
junction uith FCBHEUFCBV uhen relocating the FCB. 



It is eight 



This is the account nana of the file. 
bytes in length uith trailing blanks added. 



This is the blocking factor of the file. It is the nun- 
ber of logical records in a physical block. Legal values 

-arse fro-- " tc 7%%. 



This specifies the device on which the file resides. If 
it is positive then it represents a logical device mmber; 
if negative it represent* a (negative) device class index. 

This is the pending FCLOSE disposition for the file. 
Legal values art: 

- no change 

1 - save pemantnt 

2 - save temporary and rewind 

3 - save tenporary but do not rewind 

4 - release 

7 - invalid file (file label access error) 

This bit governs if space uill be returned beyond the EOF 
upon the last FCLOSfc of the file. 

- no change 

1 - return space beyond EOF 



This is the device type nunber of the first extent of the 
file. See RC80TYPE for a list of legal values. 

Block nunber of the file's EOF, relative to FCBSTflRT. 

This is the end-of-file pointer for the file. It is a 
double integer r epr ese nting the nunber of records in the 
file. It can also be viewed as the record nunber of the 
next record past EOT. 

This is the exclusive status of the file access. If -1 then 
the file is being accessed exclusively; otherwise it is the 
nunber of setii-exclusive accessors. 

This is the extent nap of the file. The nunber of ex- 
tents is specified by FCBNUTOTS; a OD extent 
descriptor indicates that the extent has not been 
allocated. 

This is the extent size, in sectors, of the file, nil en- 
tents in the file except possibly the last have this size. 
This is a logical value, and legal values range fron 1 to 
65535 sectors. This restricts the naxinun file size to 
2097120 sectors (268,431,360 uords). 

This is the end-of-space pointer for the file. It is a 
double uord integer representing the naxinun nunber of 
records (fixed length record fornat) or blocks (un- 
defined or variable length record fornat) in the file. 



This is the FOPTIONS in effect for the file. 
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FCBBN Thii it thi group nana of thi fill. It it tight bytti long 

uith trailing blank* added. 

FCBLHBEL Thit it the logical device and lector nunber of the fill 

labtl, uhich it tht tant at tht firtt Mttnt descriptor. 

FCBLRSTEXTSIZE This it the tizt, in lectori, of the laat extent in the 
file. Zf the file hat one txtent then thit it tht tant at 
FCBEXTSIZE; otheruite thit value nay be different fron 
FCBEXTSIZE. Thit it tht tizt of tht last physical extent 
for the file; it it not tht size of the latt allocated 
extent. 

FCBLBL This it tht nunber of uttr labels allocated for the 

file. Since each label it a sector long, this is also the 
nunber of sectors allocated for uter labels. 

FCBLBLEOF This it the end-of-data pointer for the uter labels. It 

it analogous to FCBEOF in that it represents the nunber 
of labels uritten. The initial value is 0. 

FCBLOEV This it the logical device nunber of the first extent of 

the file. 

FCBLKST This is the previous lock state of the file and is 

derived Fron the file label. Legal values are; 

- no accessor! 

1 - read 

2 - urite 

3 - read/urite 

FCBtlVTABX If the file resides on a private volune, then this field 
represents the nounted volune table index of the volune set 
entry on uhich the file resides. 



This is the OST of the neu FCB for the file. It is used 
in conjunction uith FCBRCBDST to Move the FCB to a 
systen (shared FCB) control block table uhen the second ac- 
cessor is established. If this value is zero then 
there is no neu FCB; if nonzero then a neu FCB has been 
created. 

This is the vector table entry of the neu FCB for the 
file. It is used in conjunction uith FCBflCBV to nove the 
FC8 to a systen (shared FCB) control block table uhen 
the second accessor is established. If this value is zero 
then there is no neu FCB; if nonzero then a neu FCB has 
been created. 



This is the naxinun nunber of extents, less one, 
alloued for the file. It is not the nunber of extents 
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presently allocated, uhich it alnayi dettmined by 
counting nonzero entritt in tht txttnt nap. 

FCBNUhOPENCLSREC Nunber of open and dote records in tht nettagc filt. 

FCBOCHT Thit it tht nunber of accestors for the file. 
Alternatively it can be vieued as the nunber of PRCBt 
created for the file. 

Thit is the nunber of file accetsors having input 
access. 



FC80CNTIN 
FCBDCNTDUT 

FCBRIH 

FCBSECTOFF 

FCFJSECTPBLK 

FCBSIZE 



FCBSU8TYPE 
FCBUSERLBL 



This is the nunber of file acceesort having output 
acceat. 

This is the RIR nunber uted to support dynanic locking 
(i.e. FLOCK and FUNLOCK) for the file. If there is no 
dynanic locking then this nunber is zero. 

This is the sector offset fron the file label to the 
first block of the file. This is not necessarily equal to 
FC8LBL+1 since an integral nunber of blocks in allo- 
cated for the file and user labels. 

This it the nunber of lectors in a block for the file. 

This is the size, in words, of the conplete FCB. It in- 
cludes the extent nap. 

Block nunber of the file's start, excluding the file 
label block. 

This is the device subtype nunber of the first extent. 

This field describes the user labels for the file. It con- 
sists of FCBLBL and FCBLBLEOF, described separately. 

If the file resides on a private volune set, this bit nask 
signifies uhich volune of the set in uhich the file resides. 
Bit 15 is on it resides on the first volune, bit 14 if on 
the second, etc. 
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File Systen 



File Label (FLAB) 
The file label has the following fomat: 



File Label (Cont.) 



1 



3 



7 8 



12 13 14 15 



CREATION DATE 



FILE NAtlE - 1ST CHBR. I FILE NBIIE - 2ND CHAR. I 



FILE NRflE - 3RD CHAR. 
FILE NAI1E - STH CHAR. 



I FILE NAItE - 4TH CHAR. 
I FILE NflhE - 6TH CHAR. 



FILE NBIIE - 7TH CHAR. 
GROUP HAHE - 1ST CHAR. 



I FILE NflhE - STH CHAR. I 
1 

| GROUP NABE - 2ND CHAR. I 



GROUP NBIIE - 3RD CHAR. 
GROUP NAI1E - STH CHAR. 



| GROUP NAHE - 4TH CHAR. 
| GROUP NAItE - STH CHAR. 



GROUP NAtlE - 7TH CHAR. 
ACCT NAtlE - 1ST CHAR. 



| GROUP NAflE - 8TH CHAR. 
I ACCT NAtlE - 2ND CHAR. 



ACCT NAtlE - 3R0 CHAR. 
ACCT NAtlE - 5TH CHAR. 



I ACCT NAtlE - 4TH CHAR. 
I ACCT NAtlE - 6TH CHAR. 



ACCI NAtlE - ?IM CHAR, i ACCI NABE - STH CHAR. 1 



CREATOR NAI1E - 1ST CHAR. 
CREATOR NAHE - 3RD CHAR. 



I CREATOR NAI1E - 2ND CHAR. 
I CREATOR NAI1E - 4TH CHBR. 



CREATOR NAI1E - 5TH CHAR. 
CREATOR NAI1E - 7TH CHAR. 



I CREATOR NAI1E - 6TH CHBR. 
I CREATOR NflllE - 8TH CHBR. 



LOCKUORD - 1ST CHBR. 


LOCKUORD 


- 2ND CHAR. 


LOCKUORD - 3RD CHBR. 


LOCKUORD 


- 4TH CHAR. 


LOCKUORD - 5TH CHBR. 


LOCKUORD 


- 6TH CHBR. 


LOCKUORD - 7TH CHAR. 


LOCKUORD 


- STH CHBR. 


SECURITY I1ATRI5! 


FILE LANGUAGE ATTRIBUTE 




1 SR 1 S 



FLL0CNBI1E 

1 

2 

3 

4 FLGRPNBtlE 

5 

6 

7 

10 FLACCTHBI1E 
11 
12 
13 

14 FLUSERID 
15 
16 
17 

20 FLLOCKUORD 
21 
22 
23 

24 FISECI1X 
25 
26 
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LAST ACCESS DATE 


LAST tlOOIFICBTION DATE 






FILE CODE 




C I 




I BVTHBX I VflASK 




S I 


R I L I 


X I SUBTYPE | DISC TYPE 


R/U 


NO. 


USER LABELS URITTEN I NO. USER LABELS AVAIL. 




FILE LII1IT IN BLOCKS 



CHECKSUI1 
COLD LORD ID 



FOPTIONS 
RECORD SIZE IN BYTES 



BLOCK SIZE IN UOROS 



LAST EXTENT SIZE IN SECTORS 



I NO. EXTENTS -1 I 
— -I 



EXTENT SIZE IN SECTORS 



END OF OATH POINTER 



VOLUItE TABLE INDEX I 

1ST EXTENT SECTOR NUMBER 
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27 


FLCREATE 


30 


FLLRSTACC 


31 


FLLASTI10D 


32 


FLFILECODE 


33 FLPVINFO 


34 


FLLOCK 


35 


FLUSERLBL 


36 


FLFLItl 


37 




40 


FLFCBVECT 


41 




42 


FLCHECKSUfl 


43 


FLCLID 


44 


FLFOPTIONS 


45 


FLRECSIZE 


46 


FLBLKSIZE 


47 




50 
51 


FLLASTEXT- 

SIZE 
FLEXTSIZE 


52 


FLEOF 


53 




54 


FLEXTIIflP 


55 











File Systen 


File Systen 






Fjje label (ConM 


FLSECURE 


• FLA8(22).(1S:1)«, file secure bit 






(FLSRRELEASE)' FLABI22). (14:1)1, STORE/RESTORE released bit 






FLCLASSFL6 


= FLPVIHF0.(0:1)«, Class flag bit 










FUWTABH 


■ FLPVINF0.(4:4)«, (tainted volune table index 










FIVIIASK 


» FLPVINF0.(8:8)», Volune nask 










(FLSTORE) 
FLRESTORE 


' FLA8(28). (0:1)4, file being stored 
= FIAB(2S).(1:1)», file being restored 












VOIUIE TABLE INDEX | 




(FLLOAD) 


' FLR6(28).<2:1)», file loaded 










FLEXCL 


• FLAB(28). (3:1)4, exclusive access 






LOST EXTENT SECTOR NUHoW 




FL4H 


= FIA8(28). (0:2)4, SIR bits 










FLSRL 


= FLAB(28). (0:3)4, S, R, & I bits 










(FISRIX) 


= FIAB(28). !0:4)i, S, R, I, & X bits 










FLSUBTYPE 


= FLA8(28).(4:4)t, device subtype 










FLDTVPE 


= FLA8(28). (8:6)4, device type 










FLSTATUS 


s FLA8(28). (14:2)4, urite/read status 


: 






154 FIALLOCTTJC 


(FLLBLEOF) 


" FLB8(29). (0:8)4, no. labels written 






FILE ALLOCUTION TIIK 




(FLLBL) 


« FLAB(29). (8:8)4, no. labels available 








155 


FLSECTOFF 


= Fl*B(39). (0:8)4, sector offset to data 










FlHUntXTS 


= FLAB(39).(11:5)*, no. extents less 1 


' 




FILE ALLOCATION DOTE 


156 FLALUKOATE 


FLLABEL 


= FLA8D8L(22)», label VTflB and sector 






160 FLSTART 


FLVTAB 
Discussion: 


= FLAB(44). (0:8)4, label VTAB index 










START OF FILE BLOCK HUHBER 














161 


FlACCTHAnE 


This is the account nane of the file. It it eight 








162 FLEW 




bytes in length uith trailing blanks added. 




BLOCK NLtkKR OF END OF FILE 


163 


FLALUKOATE 
FLALLOCTME 


Date that the file uas allocated on this systen. 










Doubleuord containing the tine that the file uas al- 








164 FLNUnOPENClSREC 




located on this systen. 




HJieEB OF OPE* AND CUK RECORDS (NESSACE FILE) 














165 
166 


FLBUCSIZE 
FLCHECKSUII 


This is the block size, in sectors, of the file. 

This is the exclusive-OR checksun of the file label (ex- 




**" — - - — 




ubt nit newFicnTiun tire < FutantnE 




cluding uords 34, 42, and 43 octal) and is used for error 






1 167 




detection. Each tine the file label is read fron disc the 






. ........... .-..( 




check sun is calculated and conpared against the value 






I 170 




recorded in the file label. Sinilarly, each tine the file 




UNUSED 




label is uritten to the disc the check sun is calculated 








173 

174 FLDEVNSTIE 


PLC LIB 


and inserted into the file label. 

This is the cold load nunber in effect the last tine that 




DEVICE NATIE 


- 1ST CHAR. | DEVICE NAM - 2ND CHAR. 










the file uas accessed. This should aluays be the current 


1 DEVICE WK 


- 3RD CHAR. | DEVICE NflnE - 4TH CHAR. | 175 
1 




cold load nunber. If it is not, it neans that the systen 
crashed uhile the file uas open and that the data in the 


1 DEVICE NM1E 


- 5TH CHAR. | DEVICE NfitlE - ETH CHAR. | 176 




file label should be "reset" (principally the FCB vector 
FLFCBVECT). 


1 DEVICE NUDE 


- 7TH CHAR. | DEVICE HB11E - 8TH CHAR. I 177 








fLCREATE 


This is the creation date of the file. It is in the for- 








nat defined by the intrinsic CALENDAR. 


Other identifiers used: 
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File Systen 




' FIDEVKAHE 


This is the FOPEN device specif lotion that uas used Mhen 




1055 TOP Proof Harked SHARKED 




the file mss created. This infomation is needed uhen neu 




1056 TOP Proof Harked non-COBOL File 




extents are allocated. 




1057 TOP Proof Harked COBOL File 
1051 TOP Uorkf ile 


FLDTYPE 


This is the device type nunber of the first extent of the 




1059 TOP Uorkfile (COBOL) 




file; see ACOOTVK for a list of legal values. This 




1060 WE Punch File 




value is detemined by configuration. 




1070 OUERY Procedure File 
1080 KSAH Key File 


FLEHD 


Nunber or current data blocks (that is, the end of file 




1083 GRAPH Specification File 




block nunber relative to the start OF file). 




1084 (her Logging Log File 
1090 Self-describing File 


FLEOf 


This is the end-«f-file pointer for the file. It is a 




1100 HPIURD Docunent 




double uord integer representing the nunber of records in 




1101 HPUOR0 Hyphenation dictionary 




the file. It can also be viewed as the record nunber 




1102 HPUORO Configuration Filt 




of the next record past EOF. 




1103 HP 2601 Environnent File 
1110 IDS/3000 Character Cell File 


FLEXCL 


This is the exclusive access flag for the filt. If set it 




1111 IDS/3000 Fom File 




neans that the file has been opened exclusively by a single 




1112 IFS/3000 Environnent File 




accessor. If not set then the file is potentially 




1114 Graphics Iitage in RASTR Fomat 




accessible by others. 




1130 OPT/3000 Log File 






1131 TEPE/3000 Script File 


flexthrp 


This is the extent nap of the file. The nunber of ex- 




1132 TEPE/3000 log File 




tents is specified by FLMMEXTS; a 00 extent 




1133 APS/3000 Log File 




descriptor indicates that the extent has not been 




1139 HPEDCP/DRP Log File 




allocated. 




1140 HPToolset Root File 

1141 HPToolset Data File 


FLEXTSIZE 


This is the extent size, in sectors, of the file. All ex- 




1146 Orauing File for HPORAU 




tents in the file, except the last, have this extent size. 




1146 Figure File for HPORAU 




This is a logical value, and legal values range fron 1 to 




1147 Reserved 




65535 sectors. This Units the naxinun file size to 2097120 




1148 Reserved 




sectors. 




1149 Reserved 

1152 Conpressed SLATE File 


FLFCeVECT 


If nonzero, this is the vector of the FC8 for the file. 




1153 Expanded SLATE Uorkfile 




If zero, the file is not being accessed. 




1156 Store File for RAPID/3000 Utility DICTDBU 


FIFILECODE 


This is the file code of the file. Known values are: 




1157 Code File for Transact/3000 Conpiler 

1158 Code File for Report/3000 Conpiler 

1159 Code File for Inforn/3000 Conpiler 




1024 User Subprogram Library 




1166 HPOESK Distribution list 




1025 Basic Data 




1167 HPOESK Text 




1026 Basic Progran 




1177 Tern Type File 




1027 Basic Fast Progran 




1178 Tern Vertical Fomat Control File 




102! Relocatable library 




1192 Netuork Configuration File 




1029 Progran File 




1193 Netuork Trace File 




1031 Segnented Library 




1194 Netuork Log File 




1035 Vieu Fom Filt 




1211 ANODE 




1036 Vieu Fast Forns File 




1212 INODE 




1037 Vieu Refornat File 




1226 VC File 




1040 Cross Loader ASCII File (SAVE) 




1227 DIF File 




1041 Cross Loadtr Rtlocated Binary File 




1228 Language Definition File 




1042 Cross Loader ASCII File (DISPLBV) 




1229 Character Set Definition Filt 




1050 Edit Quick File 




1230 Formatted Application hsssage Catalog 




1051 Edit KEEPS File (COBOL) 




1235 Reserved 




1052 Edit TEXT Filt (COBOL) 




1236 Reserved 




'051 T5P Siary Filt 
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Pathfleu STATIC fill 
Pathflou DYHAflIC Fill 



Retirvid for RPL 



FLFOPTIONS 

FlGRPNfinE 

FLLfiBEL 

FLLASTACC 
FLLASTHOD 
FLLASTEXTSIZE 



1251 
1259 

8000 

to 
8039 



This it the end-of-tpaee pointir for tht fill. It it a 
double intiger representing the naxinun nunbir of 
records (fixed length record fomat) or blocks (un- 
defined or variable length record fomat) in the file. 

This is the FOPTIONS of the file. 



It is light bytes lcng 



FLIOCK 
FLLOCKUORD 



This is the group name of the file, 
uith trailing blanks added. 

This is the volume table index and sector number of the file 
label, uhich is the sane as the first extent 
descriptor. 

This is the last access date of the file. It is in the for- 
nat defined by the intrinsic CALENDAR. 

This is the last nodification date of the file. It is in 
the fomat defined by the intrinsic CALENDAR. 

This is the size, in sectors, of the last extent in the 
file. If the file has one extent, then this is the sane as 
FLEXTSIZE; if the file has more than one extent, then this 
value nay be different fron FLEXTSIZE. This is the size 
of the last physical extent for the file; it is not the size 
of the last allocated extent. 

This is the nunber of user labels allocated for the 
file. Since each label is a sector long, this is also the 
nunber of sectors allocated for user labels. 

This is the end-of-data pointer for the user labels. It 
is analogous to FIEOF in that it represents the nunber 
of labels uritten. 

This is the LOADED flag for the file. If set, it neans 
that the file is a loaded progran or SL file and cannot be 
Modified except by a privileged accessor. This flag is set 
and cleared by the loader, not the File systen. 

This identifies the uord containing the lock bits, 
uhich are described separately. 

This is the lock uord of the file. It is eight bytes long 
uith trailing blanks added. If it is all blanks, then the 
file does not have a lockuord. 
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FLIOCNAHE 



FLH0DTME 



Thii is thi local nine of the fill, 
uith trailing blanks added, 

Lait tini thi fill uai nodifiid. 



It it light bytn long 



FLNUHEXTS Thii it thi nunbir of txtinti, lm em, alloutd for thi 
fill. It it not thi nunber of ixtmti allocated. Ltgil 
valuet range fron to 31, i. e. t 1 to 32 extent!. 

FLMIHOPENCLSREC Hunber of open and close rtcordi in thi nlitagi fill. 

FLPVINFO Fill label private volune information. This it in thi lanl 
fomat at the FCBPVINFO. 

FLRECSIZE Thit it the record tizi of the file in negative bytes. 

FILESTORE This is the RESTORE flig for the fill. If tit, it neant 
that the fill is biing RESTOREd and cannot bi accessed. 
RESTORE alto tett the STORE bit for the file (FLSTORE); tee 
FLSR for a full description of the ute of thete bitt. 
This flag it tit and cleared by STORE/RESTORE, not thi 
fill tyttin. 

FLSECJIX This it the security natrix of thi fill. The bitt 
are organized into fivi groupl of tix bitt Itch. (Bitt 0:2 
are not uted. J The groups correspond to the access types: 
READ, APPEHD, IIRITE, LOCK, and EXECUTE. Uithin each group, 
each bit specifiet uho nay have the access: ANV, ACCOUNT 
NGR, ACCOUNT LIB- RARIAN, GROUP, CROUP LIBRARIAN, CREATOR. 

FLSECTOFF This is the lector offtet fron the file label to the 
first block of the file. This is not necessarily equal to 
FLLBLil since an integral nunber of blocks are allo- 
cated for the file and user labels. 

FLSECURE This is the file security enforcenent flag for the 
file. If not set, then the file has been RELEASEd and the 
security natrix FLSECnx should be ignored. If set, then 
secure as specified by the security natrix. 

FLSR This is the STORE and RESTORE flags for the file, uhich are 
described separately. STORE and RESTORE decode the tuo-bit 
field to indicate their operation. Legal values are: 

- file not in use by either STORE or RESTORE 

1 - illegal value 

2 - file being STOREd 

3 - file being RESTOREd 

The file systen interprets the leftnost bit as in- 
dicating that the file is being accessed by either STORE 
or RESTORE. The rightmost bit is interpreted as indicating 
uhat access should be permitted: (file being STOREd) 
allous read access; 1 (file being RESTOREd) allous no 
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FLSRL 
FLSRLX 
FLSRRE LEASE 



FLSTART 
FLSTATUS 



File Systen 



access. This field is set and reset by STORE/RESTORE, 
not the file systen. 

This is the STORE, RESTORE and LOADED flags for the 
file, uhich are described separately. 

This is the STORE, RESTORE, LOADED and exclusive flags for 
the file, uhich are described separately. 

This flag is used by STORE/RESTORE. If a file is 
STOREd uith the ";RELEASE" keyuord, STORE uill set this flag 
in the tape copy of the file label. RESTORE uill allou 
any user to access such files, regardless of the file's nor- 
mal security. If this bit is off in the tape copy of the 
file label, RESTORE applies normal security checks (as 
defined by the information in FLSECnx and FLSECURE). 
This bit is zero for files on disc. 
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excluding the file 



FLSU8TYPE 

FLUSERID 
FLUSERLBL 

FLVTHB 



Slock number of the file's start, 
label block. 

This is the read/urite status of the file. Legal 
values are: 

- no accessors 

1 - read 

2 - urite 

3 - read/urite 

This is the STORE/RESTORE flag for the file. If set it 
neans that the file is beinj either STOREd or RESTOREd. The 
RESTORE bit (FLRESTORE) nust be interrogated to determine 
uhich operation is taking place; see FLSR for a full de- 
scription of the use of these bits. This flag is set and 
cleared by STORE/RESTORE, not the file systen. 

This is the device subtype nunber of the first extent of 
the file. This value is determined by 
configuration. 

This is the creating user name of the file. It is 
eight bytes long uith trailing blanks added. 

This field describes the user labels of the file. It con- 
sists of FLLBL and FLLBLEOF, uhich are described 
separately. 

This is the volune table index of the first extent of the 
file. 
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File llulti-Access Vector Table (FrlBVT) DSKZ54) 



The FHRVT is used to locate shared PACB'e for files opened nulti-access. 
Uhen an old disc file has been opened nulti-access, the FHAVT is searched to 
determine if the file has previously been opened. The JITDST and the DADOR 
found in the FNAVT are conpared to the JITDST of the job and the DADDR of the 
device or disc file being opened nulti-access. If an entry exists for the 
file, then the PflCB can be easily located for that file. If this is the 
first process opening the file, then an entry is created and inserted into 
the FnVAT for the file. 

Spoolfiles are opened nulti-access, therefore, they uill have entries in the 
FIWVT. »STDIN and ISTDUST also have entries in the FHAVT since they too are 
opened nulti-access. 



Zero Entry Fomat 



CURRENT TABLE SIZE 
ENTRY SIZE * 6 



BBXlnun TABLE SIZE 






I FII'CURR'SIZE 
-I 

I 1 FrTENTRY'SIZE 

| 2 Frl'rlAX'SIZE 



I 3 
-I 
I 4 



I 5 



Descriptions: 

FII'CURR'SIZE The current size of the FffiWT in uords. This value increases 
in increments of X2O0 uords until Ftl'rlAX'SIZE is reached. 

FITIIAX'SIZE The maximum allowable size in uords that the FII'CURR'SIZE can 
get. The current value of this is Z4000. Fn'RAX'SIZE can be 
changed only by changing the code in Initial. The open of the 
nulti-access file is failed if this naxinun is reached. 

Ft!" ENTRY 'SIZE Size in uords of an FHAVT entry, S uords at present. 
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Typical Entry fornat 

12 3 6 

1 I G I D I I 



12 13 14 15 



JIT OST 



LOGICAL DEVICE 



I 



DISK ADDRESS 
MO VECTOR 



I 
-I 

I 1 FN'JITOST 
-I 

I 2 fh'oaom 

I 

I 3 

-I 

I 4 Fn'PACBV 



I 5 



For device 



FrOEVICE *FHWT(0).(2:1)#, Device bit 

Fn'GLOBAL ■ FflhVT(O). (1:1)11, Global nulti-access bit 

FITLDEV x FH'DRO0R(O).(O:S)«, Logical device nunber of file 

Descriptions: 

FII'DAOOR The dice address of the file label for disc Filei. 

files, the disc address is zero. 

Fit' DEVICE This bit is 1 for device files and for disc files. 

FITLDEV Logical device nunber of device files or the LDEV of the disc 

containing the file label for disc files. 

FB'JITOST The OST nunber of the JIT for the job that has the file open. 
If this field is nonzero, then only processes in the fanily 
tree of this" particular job can open the file. This field is 
zero if the file uas open global nulti-access. 



FIT GLOBAL 



This bit is 1 if the file uas opened global nulti-accest, this 
allous nulti-access to the file between jobs. 

The PRCB vector for this nulti-access file. Used to easily 
find the Physical Recess Control Block for files opened 
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Systen Global Area (SVSGLOB) 



The file systen uses several words in the systen global area for its oun 



SHFTJOST 
DOKITOR 
MXSSECT 

kuissect 
extssect 

SP00LIH0EX 

CSIOUAIT 

CCLOSEPUfflL 

OSCHKPUtSL 

OSOPEWLRSL 

0SCL0SEPLR8L 

SDSIDEVLBBEL 

BANUCPLRBL 

GLOBALAFTDST 



■ SYS08tf76, 

■ SYSOB«77, 

• SYS06«100, 
= SYS0B«102, 
= SYSO6«104, 
= SVS06rf132, 
= SYSDB*Z13S, 
= SYS0B«140, 

■ SYSDB»Z335, 
= SVSDB«336, 
= SYSDB+Z337, 
= SYSDB»Z323, 
= SYSDB**340; 

= SYSGLBEXHZ121 



shared CBT DST no. 
nonitoring flag uord 
nix tt spoolfile sectors 
current * spoolfile sectors 
N sectors/spoolfile extent 
class spool index 
CSIOURIT PLRBEL 
CS CCLOSE PLRBEL - FPR0CTERI1 
DSCHECK PLRBEL 
DSOPEH PLRBEL 
DSCLOSE PLRBEL 
PLRBEL for SOSLOEV 
IWNRGEURITECOhV PLRBEL 
Global RFT DST nunber 



SIRs. Locks, and Deadlocks 

The file systen uses tuo SIRs: the File SIR, uhich is intended to protect 
file label integrity, and the FflAVT SIR, uhich is to guarantee the integrity 
of the FflAVT. Since the file systen locks these resources and also locks 
control blocks, deadlocks can occur if locking is done in the wrong order. 
Hot only nust the file systen handle locking correctly, but the entire en- 
senble of the file systen, its callers, and its callees nust do so also. 
These include KSflfl, which has a SIR of its own, SYSOUW, and STORE, uhich 
lock the File SIR because they tweak bits in file labels. The presently ac- 
cepted order is: 

Get FIMVT SIR Lock ACB Get File SIR Lock FCB 

It nay not be necessary to do all of these things in tny particular proce- 
dure. In Modifying a procedure, you should be sure that any of these locks 
uhich you change are consistent not only within your oun code, but also with 
its callers and callees. 
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Shared CBT DST 



In sysglobal Z76 (ABSOLUTE 11076) there exists the shared Control Block Table 
DST nunber. This DST holds a list of shared CBT's. Snared CBT's are used to 
keep any and all file systen control blocks that have the potential to be 
shared between processes. Any disc file opened shared will have its FCB kept 
in one of these CBT's. Also, all terninal PACB's uill be stored in a systen 
shared CBT so that an extra data segnent is not wasted. This is possible be- 
cause all terninal access is perforned NOBUF, uhich wane that the PACB will 
be a nininal PACB and can be placed in these CBTs. Lastly, any file opened 
with global file access will have all its control blocks placed into these 
systen CBT's. 

The fontat of the systen shared CBT DST is sinilar to a Control Block Table. 
It hae the sane uords of overhead and the data (the list of DST's) starts in 
the next word after the overhead. The systen CBT's are created one at a tine 
as needed. Usually, there are only a feu DST's in the list. 



TABLE SIZE IN UORDS [2200) 


DST HUflBER OF THIS TABLE 




















1ST. SHARED CBT DST MlffiER 




2ND. SHARED CBT DST HUHBER 




11STH. SHARED CBT DST HUHBER 
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CHAPTER 7 PROCESS TABLES 



The operating systen naintains state, control, and accounting informa- 
tion on each process. The data structures for this purpose are the 
process control block table (PCB; core resident, 1 entry per process) 
and the process control block extension (PCBX; contained in the process' 
stack belou DL). Process related information which mist be accessible 
uhen the process' stack is not present in Main netiory is Maintained in 
the process' PCB entry, fill other process related infomation is Main- 
tained in the process' PCBX. 

A process is identified in the systen by its PCB entry nunber, referred 
to as its PIN (process identification nunber), or by its 
PC8PT=(PIH)*(PCB entry size). 

The structure of the PCB table, PCB entry fornat, PCBX structure, and 
PCBX fornat are specified in this chapter. 



Process Control Block Table Structure and Fornat 
Fixed Cells Related to PCB 



4 PCB relative index of current process' PCB entry 
Z1003 SYSGLOB relative address of the PCB table base 

The bank & address are represented as per the HPEV ERS. 
Z1271 PCB relative address of head of dispatching queue's PCB 

entry 
Z1272 PCB relative address of tail of dispatching queue's PCB 

entry 
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Process 

PCB Entry fornat 



I— ■ 



* OF CONFIGURED ENTRIES 



ENTRY LENGTH (Z25) 



* OF UHBSSIGNED ENTRIES 



3ITABLE RELATIVE INDEX TO FIRST UNBSSIGNED ENTRY 
I- 



4ITBBLE RELATIVE INDEX OF LBST FREE ENTRY 



51 



HIGH UBTER MARK 



I- 
e I NUMBER OF PRIMARY CONFIGURED ENTRIES (0) 



I- 
7IHEA0 OF IMPEDED QUEUE PCB RELATIVE INDEX 



I- 
SITAIL OF ItTPEDED QUEUE PCB RELATIVE INDEX 



I- 

9INUHBER OF CURRENTLY IMPEDED PROCESSES 
| 

10INUMBER OF MAXIMUM IMPEDED PROCESSES (CURRENT! 



I- 



11IC0TOLATIVE NUMBER OF IBPEDED PROCESSES(CURRENT) 
| 

121 



131 



141 



I— 



151 

I- 
161 



171 
I- 

181 



191 

I- 
20| 
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Unassiqned PCB Entry Foi-nat 



-I 



| 

0| I 

| 1 

1 | TABLE RELATIVE INDEX TO NEXT UNASSIGNED ENTRY I 
| 1 



Process 



Assigned PC8 Entry Fomat 



1 2 3 4 5 i 7 8 9 10 11 12 13 14 15 



l-l-l-l-l-l-l-l-l-l- 



PCBOOIS IB IC |H IP IH II IP ID IL 

|A IF |R IS II IS IP |C IS |U 

|R I II II |0 |P IE I 10 I 

I I IT IH IV |R IX | IF I 

I I I I IP- II IP I IT I 



-l-l-l-l-l- 



|T ID |H IS |R 

IR IS II IT II 

|U IE IP |0 |T 

I ID IR IV IB 

I IQ II in IK 



I- 

Ml 



Z177777 



PCB01I 



| 1 

Note: Only word 1 and word 20 are valid for an unassigned PCB entry. 



SLL RELATIVE ADDRESS OF PROCESS' 
LOCALITY LIST 



SEGMENT 



I B 



Al l\ 
Dl l\ 
I /I 



PCB03I 



I Al S| 



B| S| 

Ol CI 



I I I I Bl I Ul J| T| n| SI I II S| T| n 
n i R| r| n| i| i| cl h| ii si oifai n| i| i| e 

I Gl LI Al Ol 0| P| K| Ml G| Nl I P| R| HI IT 



PCB05I 



FATHER'S PCB INDEX 



SON'S PCB INDEX 



BROTHER'S PCB INDEX 



PCB08I 



I" I 
IS I 

psin |o | oa 

IF I 

IT I 



PCE09IL | BHS | PPC IS 
II I I ID 

IV I I IV 



Dl I 

E|F | 

W MiltllllliltlitlllUilt 

DIC | 

I I 



PTYPE IS |HK|SK|ST|HB|CY|BK 
II I I I I I I 
I I I I I I I 



PCB10I 
I- 

PCB11I 
I- 

PCB12I 
I- 



EVENT FLAGS 

SEGIDENTIFIER OF LBST REFERENCED 

SUAPPABLE CODE SEGMENT 



I US 



PCB13I 
I 



D IL 
I IQ 
S I 
P I 
I 



C ID IE 

I I 
I I 
I I 



II IC |A | 

IN 10 IS | 

IT IR 10 | 

IE IE IF | 

IR IR IT | 



PRIORITY 



DBXDSINFO 

STKINFO 

UAKEMASK 



PIINFONIMPPIN 



EVENTFLAGS 

LASTREFSUBPSEG 
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Procesi 


Process 








Rtsiqned PCB Entry Fom«t (Cont.) 


.(3:1) lift, nail uait. 








.(4:1) BID, blocked I/D uait. 








.(5:1) 10, I/O uait. 


PCB14 




BLKIHX | PBX 


.(6:1) UCP, UCOP uait and RIT uait. 
.(7:1) JHK, junk uait. 








PCB15 




CST flSPPING DST * | IMPOST 

l 


.(8:1) Tin, tiner uait. 

.(9:1) flSG, file systen basic IPC message uait. 






1 


PCB16 




PinP PCS INDEX | PIHPPIN 

1 


.(10:1) SON, son uait. 
.(11:1) FR, father uait. 






___ — 1 


PCB17 




NlilP PCB INDEX | HinPPIN 


.(12:1) IMP, process waiting to be uninpeded. 
.(13:1) SIR, process uaiting for a sir. 
.(14:1) Tin, process uaiting for a tine out. 


PCB1S 




BPTUNK | BPTUNK 






j 


.(15:1) HER, process uaiting for nenory. 


PCB19 


pcb index » sew kb arm in queue i mqptr 


PC60S .(0:16) FPIN, father's PCS relative index 
PC806 .(0:16) SPIN, son's PCS relative index 


PCB20 


pcb index or previous pcb entry in queue ! pqptr 






_ ! 








PC607 .(0:16) BPIH, brother's PCB relative index 


PCBOO 


.(0:1) 


SflR ==> echtduling attention required 


PCB08 .(0:3) PSI11, pseudo - interrupt node 




.(1:1) 


Bounds Flag -- Privilege node boundt check 


1: hard kill 




.(2:1) 


CRIT ==> process is critical 


2: soft kill 




.0:1) 


HSIR ==> process has a sir 


3: stop 




.(1:1) 


PIOVR ==> pending PI, process critical 


4: hibernate 




.(5:1) 


HSPRI «> hold sir priority 


5: escape 




.(6:1) 


IPEXP — > incore protect expired 


6: break 




.(7:1) 


PC =-> pre-enpt capability 


7: noma! 




.(8:1) 


DSDFT ==> Delayed soft int processing. R pending 


.(3:1) RSOFT, OK for soft interrupt to uake process 






soft int cannot be processed because of sir 


even though it is uaiting on another event. 






or critical state. PSEUDOINT uiil be invoked 


.(4:2) OR 






when these condition(s) go auay. 


0: other source 




.(9:1) 


Ill sa> long wait 


1 : father 




.(10:1) 


SU ==> short uait 


2: son 




.(11:1) 


TRU ==> terninai read uait 


3: reply done on RIT uait 




.(12:1) 


USEDQ "> used a quantun since transaction began 


.(6:1) DERD, set during expiration. 




.(13:1) 


HIPRI —> hold inpeded priority 


.(7:1) FRC, if set, the father is to be activated on process 




■(11:1) 


STOVR ==> processing abort due to stack overfiou. 


termination. 




.(15:1) 


RITBK—> Request Infornation Table Break 


PCB09 .(0:1) LIVE, set if process is alive. 


PCB01 


.(0:16) 


SLLPTR, SLL relative index to process' segnent 


.(1:2) BUS, block nail, valid if HR set 






locality list 


0: sent to father 

1: received fron father 


PCB02 


.(0:1) 


RDB, set if DB pointing to an absolute address 


2: send to son 




.(2:14) 


XDS, DST entry nuntoer of extra data segnents to uhich 


3: received son 






DB is set; zero if none. 


.(3:2) PPC, process to process coimunication, set with 
respect to son. 


PCB03 


.(0:1) 


STOVRflLl FLAG ==> stack overfiou is already allocated 


0: null 




.(1:2) 


SC, set if executing systeti code 


1: son to father 




.(2:14) 


DST entry nuttber of process* stack 


2: father to son 
3: blocked 


PCB04 


.(0:1) 


n, nourning uait. 


.(5:1) STOV, stack overfiou bit 




.(1:1) 


RG, global RIN uait. 


.(6:3) PTYPE, process type 




.(2:1) 


RL, local RIH uait. 


0: user 
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Process 


Process 






1: user, son of Main 


Process Control Block Extension (PCBX) Structure and Fornat 






2: user, riain 








3: user, ruin, task 








4: systen 
5: 


Process Control Block Extension (PCBX) General Structure 






6: systen, UCOP 
7: 








a— > 


Dl-a * SEG. REl DL VRUfE 


» 




■(9:1) 


SI, set uhen the Dispatcher (and PSEUOOINT) 
should be auare of a pending soft interrupt. 






i 








DB-a * SEG> REl DB VALUE 


1 






.(10:1) 


HK, hard kill pseudo interrupt 






1 






.(11:1) 


SK, soft kill pseudo interrupt 






PXC-L06 






.(12:1) 


ST, stop pseudo interrupt 






1 






.(13:1) 


HB, hibernate pseudo interrupt 






1 






.(14:1) 
.(15:1) 

.(0:16) 


CY, control-y pseudo interrupt 
BK, break pseudo interrupt 

EVENTFlflGS, one for each uait class in PCB04 










PCB10 


b — > 


C-b ' PXFIXED LENGTH 


1 
I 








.(15:1) 


US, uake up Mailing switch set if an auafce is 
nissing. 






1 
I 












1 












PXFIXED EXPANSION AREA 


PXFIXED 




PCB11 


.(0:32) 


LRSTREFSUflPSEG, segnent identifier of last 




BIT RAP 


1 




PCB13 




referenced suappable code segnent. 

(QUEUING INFO) 




(4 wards) 


1 
1 
1 








.(0:1) 


DISPQ ==> on dispatching queue 




1 






.(1:1) 


L scheduling class 


PXFIXED EXPANSION 


1 






.(2:1) 


C scheduling class 










.0:1) 


D scheduling class 




PCBX 




.(4:1) 
.(5:1) 


E scheduling class 

INTER ==> process is interactive 








c — >| d-c = PXFILE LENGTH 




&E. 




.(6:1) 
■(7:1) 


CORER ==> process is core resident 
RSOFT, Rllou soft interrupt. R value of 1 




I 








1 
I 








inplies that user soft interrupts uili be 




I 








processed, fi zero value inhibits user soft 
ints (they are queued). This bit is Managed 




t 










PXFILE 








by FIHTSTflTE and FIHTEXIT intrinsics. 


I i I 






.(8:!) 


Process" scheduling priority 


PXFILE EXPANSION/CONTRACTION I 
1 i i i 




PCB14 
PCB15 


.(0:16) 
.(0:16) 


PBX, CSTX block nap index of process' progran. 
HflPOST, DST entry nunber of the CST napping 


t 

d — > 


i 

i 


l 
1 




COUNT OF SECTORS AUOCBTEO 




PCB16 
PCB17 
PCB18 
PCB19 


.(0:16) 
.(0:16) 
.(0:16) 
.(0:16) 


table. 

PIHPPIN, PCS relative index of previous inpeded PIN. 
NIflPPIN, PCB relative index of next inpeded PIN. 

BPTUNK, breakpoint link for process 

NQPTR, PCB relative index of next proc in disp queue 


DL--> 


FOR PXFIXEO EXPANSION 


\ 


/ 


Dl-c 


DL-b 


0L-» 






PCB20 


.(0:16) 


PBPTR.PCB relative index of prev proc in disp queue 

ffl,l0IIB 


1 ! 
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PXGL08 Foraat 

The PXGL06 portion of the pcbx is for job infornation, and contains the sane 
job related infomation for all processes belonging to the sane job. 

1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 

0| DL-a=SEG. REL OL VALUE 10 

| 1 

1! 0B-a=SEG. REL OB VALUE 11 

| 1 

2| USER fiTTRIBUIES |2 

| 1 

3 1 JBAT INDEX 1 3 

| J 

4 1 JPCMT INDEX |4 

| j 

5 1 JCUT INDEX 1 5 

I 1 

6ISBI R| TV ! Dl II//I//I//I//I STACK OUIP FIBGSI6 

| 1 

millllllllllllilllllim NATIVE LANGUAGE |7 
| 1 

10| ACTUAL JOB INPUT LOEV 18 

| 1 

11| ACTUAL JOB OUTPUT LOEV 19 

| 1 

121 JDT OST INDEX 110 

| 1 

131 JIT DST INOEX 111 

| 1 

R = restart bit Stack Ounp Flags 

I ■ job in/list interactive Bit 10 = Amed 

D = job in/list duplicative Bit 11 = Suppress traceback 

TV = job type Bit 12 = Suppress ASCII 

= undefined Bit 13 = 0-63 to S 

1 = session Bit 14 = QINIT to S 

2 = job Bit 15 = DL to QINIT 

3 - task 

* = reserved: 

SB= stun bit ;used for stack underflow sinulation for ICF44 or ICF55. 
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PXFIXED Bssiannents 



The PXFIXED portion of the pcbx- contains specific infornation and control 
infornation. 



c-b PXFIXED SIZE 
RELATIVE S(S-DB) 
RELATIVE Z(Z-D8) 



— I 




1 

2 

I- 
31 INITIAL Q(Q-DB) |3 

| 1 LB BDST existed 

4| INITIAL RELATIVE DL (OB-DL) |4 LP LOADPROCed 

j j Trap nodes 

5| GENERAL RESOURCE CAPABILITY(FR0I1 PROG-FILE) 15 .AT(0:1)-Arith. 

| 1 .LT(1:1)-Library 

6|AT|LT|ST|CY|CT|//|//|//|//|U |L |C |G |A ILBltf|6 .ST(2:1)-Systen 

| ~SSv.CV(3:1)-Ctl-* 

7IUNK TO XOS ENTRIES IN EXP. area I XDS CNT |7 t*T(4:1)-Code 

| 1 (jlW gpc exist 

101 P| SI EXTRA DATA SEGBENT DST INOEX 18 L LogJSjM 

| 1 c Share Hock 

111 Pi S| EXTRA DATA SEGBENT DST INDEX 19 GHobal Rflt'icaaired 



121 P| SI 
i- 



EXTRA DATA SEGBENT DST INDEX 



131 PI S| EXTRA DATA SEGBENT OST INDEX 
| 

14| X| A| ABORT V 
| 

151 riflXIBUB STACK SIZE(BAXDATR LIBIT) 
| 

1SI ARITHMETIC TRAP BASK 



I ACAcct UOC exiiC 
110 V 0:1 RESERVED >«R 
| f. CST EXPANSION":, 
(11 I 1;1 = 1 IF ABORT 

"•]*" '" IK PROGRESS 

|RU| INITIAL CST -WOE* 112 < l ?4j.. ; = IF HAVE R/U 



I- 
171 



201 

I- 
211 



ARITHMETIC TRAP PLABEL 



U8RARY TRAP PLABEL 



22| 



SVSTEB TRAP PLABEL 
CONTROL V PLABEL 



-I 
(13 
-I 

114 

115 \ 
-I 

116 
-I 

117 
-I 

118 



•ncass to 

PROG FILE 
= 1 OTHERWISE 
tfr^tSLt OF SEG 
IHITIALLY^EXECUTED 
AT PROCCREATION 



CODE TRAP PLABEL 



— I 



231 

| 

24| DATA COB TERMNATION TRAP PLABEL 
| 

25| IBAGE TRAP PLABEL 

| 

26| RESERVED 

| 1 

27ICUR.BAX STBCK SIZEUargest value ever for Z-0OI23 
| 1 
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119 
-I 
1 20 



121 
-I 
1 22 



PXFIXED Hssiqnnents fCont.) 



SOI 

I 

311 



PROCESS CPU TIBE 
(BSEC) 



321 



124 
! 

125 
-I 



PXFIXED Assinnnents (Cont.) 



60|/|D|/10| RESERVED FOR FUTURE SOFT INT USE 
/ICI/ISI 

/m/in 



TRLX INDEX FOR KERNEL TIBEOUT PROCEDURE 



BAXIBUB DATA SEG SIZE USED(IN SECTORS) |26 



331 TOTRL VIRTUAL STORAGE USEDtfN SECTORS) 127 

| 1 

34| CURRENT EXTRA DATA SEGMENT SPACE 128 

I 1 

35| BAXinUB EXTRA DATA SEGBENT SPBCE I 29 

| 1 

36| PRK BODE BOUNDS FLAGS I STOV COUNT | 30 

| 1 

37| PROCESS EXECUTION TIBE REMINDER (IN BSEC) I 31 
| 1 

40| SET TO-1 UHEN IN BREAK BODE* I 32 



41| 



62ITV I JOB/SESSION NUMBER 

I 
63!< — (reserved ) 



641 



651 
I- 

66| 



671 



RESERVED FOR FUTURE USE 
RESERVED FOR FUTURE USE 



RESERVED FUR FUTURE USE 
RESERVED FOR FUTURE USE 



CONTINUE FLAG (iCONTINUE COBBBHO)** 



I 33 
-I 



42IACTUBL SIZE OF VIRTUAL SPACE ALLOCATED TO STACK 34 



I- 
431 



44| 
451 



ERROR LEVEL 



INTRINSIC ERRORS 



INTRINSIC ERRORS 



36 
36 
I 37 



461 
I- 

471 



SOI 

I- 
511 



INTRINSIC ERRORS 



— I 



INTRINSIC ERRORS 
INTRINSIC ERRORS 



I 38 

-I 
I 39 



I 40 



I- 



INTRINSIC ERRORS 



52ITSLR, virtual tine since last rescheduled 



142 



53ITSTB, virtual tine since transaction began J43 
| | 

54ITSSUBPIN, virtual tine since suapin 144 



145 



55ITSLA, "irtual tine since last absence 



I- 



56ITSL0, virtual tine since last deallocation 



I- 



146 



57JQCNT, quantuns used since transaction began |47 
I - I 
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70| |CV| |SI| 
| 

71 | TIBEOUT TRLX 



| 



nuiiiiiillliilllllllllimitlltlilliiiiiiiliilil 



73 1 itinmiiuiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiii 
I 

74| PCLASSBBSK 
| 

751 

I- 
761 

I 
771 



PROCQUESTOPUORD 



1141 

I 

1171 



PXFIXED EXPANSION BITBBP 



49 

JOB TYPE: 
50 1 SESSION 

2-J08 
51 

52 

53 

54 

55 

56 

57 

5! 



NOTES: P = 1 if opened by priv user 

S = 1 if data segHent is sharable 

PCLASSBBSK = BIT BASK OF CLASSES THIS PROCESS HAS ENABLED 
PROCOUESTOPUORD.(0:4) = PROCESS PRIORITY: 7 => L QUEUE 

6 -> C QUEUE 
!=>[ QUEUE 
1 => E QUEUE 

0.01.00 
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.(4:12)« REASON STOPPED: 1 => STOP SEG FAULT 

2 => STOP DISC UA1T 

3 => BLOCKED I/O, HON TERMINAL 

4 => TERMINAL REAO 

5 => STOP IMPEDE 

6 => STOP ACTIVE 
PROCSTOPTIME • 08L WW TMESTAMP OF UHEN PROCESS STOPPEO FOR 

REASON GIVEN IN PROCOUESTOPUORO 

DCV A DELAYED CONTROL V IS PENDING (THIS 8IT 

IS CHECKED BV IHIN ON BOUNDS VIOLATION TO 
DETERMINE IF COT: 1) TRUE BOUNOS VIOLATION 
OR 2) AN INDUCED BOUNDS VIO THAT INDICATES 
THAT THE CONTROL 1 TRAP PROCEDURE HRV HOU 
BE ENTERED). 

OSI STATE OF THE "ASOFT" PCB BIT UHEN CONTROL V 

TRAP UBS ENTERED. ASOFT = 1 ALLOUS USER SOFT 
INTERRUPTS AGAINST THE PROCESS. IT IS SET TO 
ZERO UHEN THE CONTROL V HANDLER IS ENTERED. 
IT IS SET TO ITS PRIOR STATE UHEN THE USER 
CALLS RESETCONTROL. 
« SET TO COtMND RECORD LENGTH UHEN COMMAND PENDING 
(I.E. CaiOHO ENTERED DURING BREAK OR ENCOUNTERED 
DURING FLUSHING). 

*« CONTINUE FLAG VALUES 

= NO CONTINUE IN EFFECT 

1 * CONTINUE JUST ENCOUNTERED 

2 * CONTINUE IN EFFECT FOR THIS COIDIRND 



CV FLAG 



PCBXFIXE0(56).(1:1) 



SI FLAG 



PCBKFIXED(56).(3:1) 



= SET BV PSEUDOINT UHEN THERE IS A PENDING 
CONTROL V UHICH CANNOT BE PROCESSED BECAUSE 
OF SYSTEM CODE OR PRIVILEGED CODE. IHIN 
CHECKS THIS BIT ON BOUNOS VIOLATION OR 
TRACE TRAP. 



= SPECIFIES THE STATE OF THE USER INTERRUPT 
FLAG UHEN THE CURRENT CONTROL V UAS PROCESSED. 
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PXFIXED Expansion Bitnap 

The PXFIXED bitNap and expansion ana is For use in accounting 
of extra data segments acquired by the process. 



File Systen Section of PC BX (PXFILE) 



The PXFILE area is a subsection of the PCBX. It is a contiguous, expandable 
and contractible block of storage that is nanaged by the file systen 
prinarily for its own use. Other subsystens, nanely CS and DS, also naxe 
use of the PXFILE section. In doing so they mist confom to the 
conventions of the file systen. 

The overall structure of the PXFILE area is: 



OVERHEAD 



CONTROL BLOCK 
TABLE 



ACTIVE FILE 
TABLE 



(FIXED) 



(VARIABLE) 



(VARIABLE) 



(VARIABLE) 



I DL-S 
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Overhead 



The part labeled Overhead contains infomation that pertain to the 
entire section. It is addressed via the pointer at DL-3. 



I PXFILE SIZE IN UOROS 




1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 
15 
IE 
1? 


PXFSIZE 


1 LUST DOPEN ERROR NO. I LAST COPEN ERROR NO. 

1 N | 

i LAST OS AFT 

I SLAVE AFT NlinBER 




I LAST KOPEN ERROR NUMBER I LAST FOPEH ERROR NUMBER 




I AFT SIZE IN UORDS 
! CS TRACE FILE INFO 


PXAFTSIZE 
(PXCTRINFO) 


j LAST RESPONDING NO-UAIT I/O AFT ENTRY NUMBER 
I 1ST USER (NOBUF) CONTROL BLOCK TABLE DST ".IJH8F.R 


PXfLEFTOFF 
PXFCBT1 


I 2ND USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFC8T2) 


I 3RD USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFCBT3) 


I 4TH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFCBT4) 


I 5TH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFCBT5) 


I ETH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFC8T6) 


1 7TH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFC8T7) 


1 8TH USER (NOBUF) CONTROL BLOCK TABLE DST NUMBER 


(PXFCBT8) 



Partial uord field identifiers are: 



PXFDQPEN 
PXFCOPEN 
PXFNQCB 

PXFXQPEN 
PXFFQPEN 



= PXFILE(1).(0:8)tl, 
* PXFILE(1).(8:8)», 
= PXFILE(2),(Q:1)», 
= PXFIIEE5).(0:8)#, 
= PXFILE(5). (8:8)*, 



last DOPEN error code 

last COPEN error code 

no CB*s in PXFILE CBT? 

last KOPEN error code 

last FOPEN error code 
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Oiscus-sion: 

PXFRFTSIZE This is the size (in uords) of the Active File Table (RFT). 

The size is in uords to ainplify calculating the size of 

the available block. 

PXFCBT1-8 These are the DST nunber* of the user (NOBUF) control block 

tables, ft DST nunber of indicates that no data segnent is 
allocated. 

PXFCOPEN This contains the last COPEN error nunber. hot used by the 

file systen. 

PXfCTRINFO This contains infomation pertinent to the CS trace file. 

Not used by the file systen. 

PXFDOPEN This contains the last DOPEN error nunber. Mot used by the 

file systen. 

PXFDSINFO Reserved for DS. Not used by the file systen. 

PXFFQPEN This contains the last FOPEN error nunber. If it is zero 

then the last FOPEN successfully conpieted; otherwise the 
last FOPEN was unsuccessful and the nunber is the file sys- 
ten error nunber. 

PXFKOPEN This contains the last KOPEN error nunber, KSW1 is partly 

enbedded in the file systen, and an FOPEN failure on a KSRfl 
file can be caused by a failure to open either the key file 
or the data file. This error nunber is used in conjunction 
uith PXFFQPEN to detemine which file caused the KSfltt open 
failure. This error nunber is not used by the file systen. 

PXFLEFTOFF This is the RFT entry nunber of the last file/line that 

conpieted a nouait I/O; if zero then no nouait I/O has been 
conpieted. This cell is naintained solely by and for the 
IDUHIT intrinsic. 

PKFNOCB This bit signifies that control blocks are not to be 

created in the PXFILE control block table. This bit is set 
by the NOCB paraneter to the CREflTE intrinsic or the :RUN 
connand. This feature pernits the user to have as nuch 
stack space as possible; otherwise the file systen uill 
take several hundred uords oF stack for the PXFILE control 
block table. 

PXFSIZE This is the size (in uords) of the conplete PXFILE area. It 

is the sun of the overhead block, the control block table, 
the active file table and the available block, 
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PXFILE Control Block Table (PXFCBT) 

Addressing within a PXFILE control block tabic is soneuhat nore cortplicated 
than addressing an extra data segnent CBT since the table does not begin at 
DB+0. fls a result all pointers within the table are table relative; the 
starting address of the table nust be added to a pointer to generate a final 
DB-relative address. This addressing convention is consistently applied to 
all control block tables. 

Uhen the control block table is expanded, space is taken fron the MAILABLE 
area. If no space is available then the PXFILE area is expanded and the ac- 
quired space is added to the AVAILABLE area. 

Available Block 

The part labeled Available is used to provide space uhen the Control Block 
Table or the Active File Table is expanded. These tuo tables grow towards 
each other, and uhen nore space is needed it is. siriply taken fron the 
Available Block. 

Uhen the Available area is exhausted, the PXFILE area is expanded, the AFT is 
relocated and the new space is added to the Available Block. 

Currently the PXFILE area is only expanded; it is never contracted. For nore 
infomation refer Chapter 6 beginning with Active File Table page 6-7. 
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Process 

PCBX For Core Resident Systen Process Stacks 





ol 


DL-a (Seq Rel DL Value) 


1 1 DB-a (Seq Rel OB Value) 


21 


USER ATTRIBUTES (aluays -1 ) 


3| 





4| 





5| 





S| 


I 0| II 


7| 





10 1 


ACTUAL JOB INPUT LDEV 


111 


ACTUAL JOB OUTPUT LDEV 


121 





13) 
121 






PXFIXED SIZE (c-b) 


131 


RELATIVE S (S-DB) 


14| 


RELATIVE 2 (Z-OB) 


151 


INITIAL (0-06) 


161 


RELATIVE DL (OB-DL) 


171 


GENERAL RESOURCE CAPABIUTY(-I) 


201 


RESERVED 


21! 





22 1 


OL-c 


23 1 


DL-b 


24 1 


OL-a 



PXGLOB 
I 



I 

114 PXFIXED 

I 

M5 

I 

lie 

I 

117 



|20 



NOTES: 1. 
2. 



There is no PXFILE area. 

The PXFIXED area is nuch snaller than a nornal PCBX. 
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Process To Process Connunication Table 



This table is used as the connunication link by uhich father and son process- 
es connunicate uith one another via the nailbox schene. This table contains 
tuo uords per entry and is indexed by PCBN (entry index is Meaningless). 
Each tuo uord entry of index N essentially relates uhere, as uell as hou 
nuch, nail nay be found for a process N uith respect to connunications be- 
tween N and his father process. 



ENTRY FORMT 

| 1 

uord | UORD COUNT I 
| | 

uord 1 | MAIL UORD OR OST* I 
| | 

uhere uord = the # of nail uords to 
be transferred, 
word 1 = the only uord of nail 
itself if word = 1 

otherwise 
it contains the DST« of 
the extra data segnent 
uhere "uord count" uords 
of nail exist. 



NOTE: Assume process S is the son of process F. Then the process to process 
connunication table index uhich uill be used for nailbox connunication 
betueen son S and father F uill be that of the son (i.e. S). 



Process 



Subsysten Reserved OL Area 



I- 



-1 



I- 
DB-121 



I I 

REI1AINING DL AREA 

I I 



RESERVED FOR SORT/nERGE 



-I 

IDB-10 



I- 

11 RESERVED FOR TRACE, TOOLBOX, S BUSINESS BASIC IDB-9 

-I 
IDB-8 



IDB-7 
-I 
IDB-6 



EXTERNAL PLABEL OF OUTER BLOCK 



RESERVED FOR TRACE i SYMBOLIC DEBUG 



DB ADDRESS OF STLT 



RESERVED FOR COBOL 



DB-4 

DB-31 

I- 
DB-21 

0B-1I 



RESERVED FOR COBOL 
RESERVED FOR COBOL 



RESERVED FOR FORMATTER 4 PASCAL 



OB ADDRESS OF FLUT 



IDB-4 
-I 

IDB-3 
-I 

IDB-2 
-I 

ID8-1 
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Present 



F08TMM LMictl Unit Table [FU1T) 



Thi stgnenter it responsible for the preparation and initialization of > 
FORTRAN logical unit tjblt. Thit ii done uhen t progrm i> prtparad if that 
progran contain at lint ont progran unit that reftrtneti • logical unit. 
Tht location of tin FLUT it in tht ttcondary OB area and tht addretl of thit 
location it contained in OB-1 . 

Tht FLUT it formatted at ptr tht follouing txanplt: 



OB-1 


1 

X 1 






06*11 


3 


1 




4 


1 




5 


1 




7 


1 




10 


1 




255 


///I 



I 



-I I- 



Itt BYTE 
Litt of the logical unit nunbert 
referred to in thit FORTRflN- 
produced progran. 
(255 terminates). 



I 



2nd BYTE 
Tht KPE fill nunber (as returned 
by F0PEK) used in accessing the 
file. Zero if file not open. 
Filled in by fomatter as each 
l.u. is initially referenced. 
1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
-I-I-I--I--I-I-M--I--I--I--I-I--I-I- 
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Job Tables 



CHAPTER 8 JOB TBBLES 



Job Tables Overview 



Job Raster Table (jnAT): One entry per job/session. Contains 
information needed to get the job/session running. Entry is 
created at the introduction of job/session. 

Job Information Table (JIT): One DST per job/session. Contains 
information needed by the job/session as it is executing. 

Process Job Cross Reference Table (PJXREF): One DST per systen. 

Used to determine the job/session nain process (connand interpreter) 
for iny process on the system. 

Job Process Count Table (JPCNT): One entry per job/session. Entry 
number used to index into the JIR to lock job resources. 

Job Directory Table (JDT): One DST per job/session. Contains the 
following sub-tables used by descendants of job/session, dust 
obtain JIR (by using JPCNT index) before accessing JOT. Sub-tables: 

1. Data Segment Directory - Directory of sharable DSTs used by 
job/session 

2. Tenporary File Directory 

3. File Equation Table 

4. Line Equation Table 

5. Job Control Uord Table 

Job Cut-off Table (JCUT): Stores total CPU tine limit of job/session 
and accumulates the CPU tine that job/session uses. 

Ucop Request Queue: R queue of Process Identification Nunbers that 
are terminating. 
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SIR = 15(10) = 117 
DST = 25(10) = 131 



Job naster Table Structure (JMBT) 



ZEROTH 
ENTRY 
I 
I 

I 
I 



12 3 4 5 6 7 8 9101112131415 
| 1 -. 

0| IfflXSIZE I CURSIZE 10 

I 1 

11 VnOUHT INFO I ENTRY SIZE |1 
| i 

2 1 ENTRY POINTER 1 2 

| 1 

3| SCHEDULING HERD POINTER |3 
| 1 

4| SCHEDULING- TAIL POINTER |4 



IS 
16 

-I 
|7 
IS 

-I 



51 TV| 
61 



7| TY| 
101 
I- 



1 1 1 16 1 SEC I /////// 1 SFENCE/ 1 J08FNIE 1 9 



I- 
121 



S LIBIT 
SNUB 



141 

I- 
151 



161 
I- 

171 



-I 

no 
-i 

in 
-i 

M2 



JnAT SCHEDHEAD 



max JRP.T size (uords/128) 
current JnflT size (uonJe/128) 
:VnTJUNT state saved for UMUISTDRTs 
JHAT entry size (33) 
D8 pointer to first entry (38) 

DB pointer to uord of head 
entry in scheduling queue 
DB pointer to uord of tail 
entry in scheduling queue 
next assignable session It, TY=1 



next assignable batch H, TY=2 



LG=1 , logoff in progress 
SEC=0,hijh;=3,lou J06SECURITY 
maximum number sessions C E 

\ U X 
current number sessions I R E 

I RC 
naxinun It batch jobs 



i 13 current It batch jobs 



|14 DB pointer to uord zero. 



> E U 

I NT 

I TI 

/ LN 

Y 6 



201 



451 

1 = 
46! 



UORKAREA 
(23U0S) 



-I 
115 SFEKCE is session fence 



116 



137 



I 38 
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1131 



JUST (Cont.) 



175 



LAST 
ENTRY 



SCHEDULING OUEUE 

UAITING SESSIONS 

FIFO UITHIN HIPRI/INPUT PRIORITY 
[ERROR JOBS ] 

[ FIFO ) 

URITING JOBS 

FIFO UITHIN HIPRI/INPUT PRIORITY 



Job Raster Table Entry (JHAT) 



111111 
0|1:2:3|4:5:6|7:8:9I0:1:2|3:4:S 
| 1 

01 state :DII:6:B|U:C: INPRI I state 

| J = free entry 

1 ty: job/session number I 1 1 = introduced, in 

| „! 1 STRRTDEVICE 

21 job/session # I 2 X70 'scheduled in scheduled job queue. 

| 1 

3( I 3 240 = waiting, job in 

4 1 user name I 4 scheduling queue 

5| | 5 Z60 = initial, UCOP 

6| | 6 has created JSHP 

| 1 2 = executing, JSHP 

7| I 7 Finished initial. 

10| account name j 8 3 = terminating. 

11 j 19 4 = suspended. 

12| |10 D - duplicative 

j j I = interactive 

131 111 {G = group password 

141 job nane 112 {(OUIET node, if state=2) 

151 113 (A = account password 

161 114 {U = user password 

| - — | (0 = password validated(STRRTDEVICE) 

17| |15 {1 = must validate 

20I group logon nane 116 { password (INITJStIP) 

21 | " |17 R = reserved 
22i i 1 S 

| | c = JUST is device 

231 JIN device 1 19 class index 

| 1 

241 JUST device 120 

I- I 

25| Julian date (CALENDAR) 121 

j j ty - 1 - session 

26I tine (CLOCK) 1 22 2 - job 

27| I23 

| 1 

30 1 language XPRI I24 

| 1 

31 1 (lain pin 125 

I " I 

321 CPU lin. (0 deflt, -1 no lin.)|26 

I " I 

33IS|R:N:FT :0UTPRI : NUBCOPIES I27 ORIGJIN/ORIGJUST is 

j j u£e d as a scheduling 

341 ORIGJIN 128 link by UCOP when state' 

j 1 MO or Z70. DB relative ptr. 

35| ORIGJUST |29 Last entry in list contains zero (0) 

I ----- 1 
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Ml K<"t.) 



36 


JIBT CREATOR PIN 


30 


37 


P|U|M| 




31 


40 


Reserved 


32 


41 


Reserved 




33 


42 


Reserved 


34 


43 


Reserved 


35 


44 
45 


United 
Unused 





36 

3? 



Job Tablet 



Uitd uith the progrannttie creation 
of session*. 



P"Progrennatic logon 

U-URITTILLON 

N-NOURIT 



0|1:2:3|4:S:6|7:8:9|0:1:2|3:4:5 

1 1 t 1 1 1 

R • RESTART 

* ■ SEQUENCED 

S • ORIGJIN it spooled. 



FT ■ f mwy terninal 

00 - regular tern. 

01 - regular torn. , 

special logon 

10 - APL tint. 

11 - BPL tern. 



Job Tables 



6.01.00 
J- 5 



Process Job Cross Reference Table 1PJXREF ) 



DST < X62 



TABLESIZE « KPCB entries ♦ 1 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

| NUKR OF ENTRIES | 
| 1 

1 I J/S RUBER OF PIN 1 | 
| 1 

2 I J/S NuTKR OF PIN 2 | 
| , 



I- 



n I J/S HWBCR OF PIN n 



-I 



I- 



nt1 1 J/S NUSER OF PIN n*1 



I- 



This table is only used by the SHOW) comand. The entries in the table are 
•et up through PROCREATE and Modified by flORGUE. 

The job/session nunbcr it in the fomat: 

1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 



-I 00 * Unused/undefined 
II I 01 - Session 

| 1 1 ,„ , Job 

11 s Unused/undefined 
Bit 2-15 * Job/session Nunber 

R conpletely zero entry is either fron a systen process or a currently unused 
pin. 
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Job States 



JOB STATES - JNAT ENTRY UORO 0.(0:6) 

SHOUJOB - Displays job states by scanning JltflT DST (131) 

LOGON USES ALL STATES EXCEPT "SUSPEND" 



I STATE I STATE 
I HO. I KWIE 



! PROCESS I SEGflENT I PROCEDURE(S) 



1 


INTRO 


DEVREC 

JSNP 

SPOOLER 


NURSERY STRRTDEVICE ->PUTJIttT 1 
->AL10CENTRY IN SEONENT 
ALLOCUTIL 1 


170 SCHED 
1 


UCOP 


J08SCHED 


CXSTSTRERN 
SCHEDULEDSCHEO 


MO 


hUAIT 


OEVREC 
JSNP 

SPOOLER 


NURSERY 
\ 

SPOOLING 
/ 


STARTDEVICE ->SCHEDULEJOB 
SPOOLSTUFFIN ->SCH£DULEJOB 



1 X60 


INIT- | UCOP 
IRUZRT-I 
ION | 


1 UCOP | LRUNCHJOB | 
1 1 I 
1 1 1 


1 2 


EXEC | JSNP 


1 NURSERY | INITJSNP I 


1 3 

1 


TERhTN- | JS» 
ATIN6 | 


1 nORSUE | TERMNATE -EXPIRE -> I 
1 | CLEANUPJOB | 


1 

1 

1 


FREE 1 JSNP 
ENTRY | 
1 


I HORQUE | TERNINATE -EXPIRE -> I 
1 1 CLEANUPJOB ->OEALLOCENTRY I 
1 1 IN ALLOCUTIL | 


1 4 


SUSP | JSNP 


I OPIOU | CX8KAKJ0B | 



For states INTRO and UAIT, 

DEVREC *> logon cotetand originated on terninal or 
other unspooled device. 

SPOOLER => logon comand originated on spooled device. 

JSnT> => logon connand is the result of the execution of 
a :STREAN connand. (This also includes USER 
processes uhich have done progrannatic :STRFM». ) 
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Job Process Count Table (JPCNT) 
(1 Bit Entry/Running Job ) 

nehory resident 



SYSC-108 BRSE = DB»13(Z15) 
DST = 24(10) 
SIR = t3(10) 



0123456789 10 12345 



Total Configured nunber of Jobs I 

and Sessions I 

1 

Total nunber of free entries I 
I 
-I 



Bit Nap relative index of word j 
containing next free entry 



Bit Dap 

flaxinun 64 words long 



free entry = 1 
allocated entry 



I- 



-I 



A JPCNT entry nust be allocated before the nain process can be procreated. 
The JPCNT Index is located in uord 4, PXGLOBAL area, of the stack of a job or 
session. One JPCNT Index is allocated per job or session. 

The job SIR (JIR) " base*JPCNT index, uhere base is the nunber of systen 
reserved SIRs. The JIR is used to lock the Job Directory Table. 

NOTE: This table is conpletely bit oriented uith each entry consisting of 
one bit. Entries are taken fron available pool on a "first found" 
basis. A "1" found in the bit nap indicates a free entry. R 2ero (0) 
found in the bit nap indicates an allocated entry. Uord 2 of this 
table is the index of the uord in the Bit Nap uhere the next free 
entry resides, fit systen start up, this uord is set to zero (0). The 
Bit flap can he thought of as ranging fron 0-63 (64 total words - 1024 
entries). 
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Job Cutoff Table (JCUT1 
1 Entry/ CPU-United Jos 



HEI10RY RESIDENT 

SYSGLOB BASE = DB+11(S13) 

DST = 36(10);SIR = 14(10) 
SYSGLOB + 2117 = default 
CPU tine Unit for jobs 



1 2 3 4 5 6 ? 8 9 10 11 12 13 14 15 
-I — I — I — I — I — t — I — I 



l-l-l-l-l-l-l-l- 
I • OF REAL ENTRIES 
| 

I ENTRY SIZE (3) 
I- 



-I FREE HERD 
I- 



-I POINTER TO LAST ENTRY (0) 
I- 



I UNUSED 
I- 



I UNUSED 



I 
-I 

I 1 
-I 

| 2 

3 

4 

I 5 



HERDER 

ENTRIES 



(2) 



JCUTCPUC 



TYPICAL ENTRY 



tine Unit 
(seconds) 



tine count 
(nsec) 



->| POINTER TO NEXT FREE ENTRY (END Of LIST = 0) I 
| 1 



I I- 
I I 
I I- 

~>l 



I FREE ENTRY 
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Job Infomation Table (JIT) 
JIT DST is uord 11 (base 10) in PXGLOB 



111111 
0|1:2:3|4:5:6|7:S:9|0:1:2|3:4:5 
| 1 

Ol JIT DST I 



not used 



21 pointer to job info 



-I 

I 1 



8 I 2 



3| pointer to acct info 
I- 



48 | 3 
-I 



4| pointer to reserved area 59 j 4 



I- 



-I 



5| association table index I 5 
| . 1 

61 |F| 6 



I 7 
I 8 



?|ty : 

101 



111 



job nunber 



I- 



121 JITIWXP 



I- 



131 JITBPN 



I- 

141 



151 

I- 
161 



71 9 
-I 

|10 
-I 
111 



F - Job/Session-uide 
FPrifiP option flag 
(JSFPflRP) 

ty - 1 = Session 
2 » Job 



JITHRXP - BAXJOBPRI capability 

JITBPN - Job nain PIN. 

JITEOF - used by FCLOSE to tell CI 
that a ISTDIN(X) file uas closed 
u/out encountering an EOF. 
(0:1)=«ST0IN, (1:1)=«STDINX 

JITRSEC^Rccount Security 



JITGSEC (2 uords) 
group security 



114 



»l 



JITHflN (4 uords) 
account nane 



116 



24 1 



JITHCN (4 uords) 
hone group 



30! 



JITLGN (4 uords) 
log-on group 



I24 



0I1:2:3|4:5:6|7:8:9|0:1:2I3:4:5 
111111 
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Job Tables 



JIT (Cent.) 



JIT (Cont.) 



111111 
0|1:2:3|4:5:6|7:8:9|0:1:2|3:4:5 
| 1 

341 128 

35| JITUN |29 

361 user nane 1 30 
371 131 

| 1 

40 1 pointer to JITRIP S3 1 32 
| 1 

41 |P|n: pointer to JITGIP 55 1 33 
| 1 

42 1 LRTTR 1 34 

43 1 local attributes 1 35 

| 1 

44 1 PflSSF 1 36 

45 1 passed file pointer 1 37 

| 1 

46 1 UCRP 1 38 

47| user capability * |39 

| 1 

50 1 Reserved for DS'II |40 

| 1 

51I///////////////////////////////I41 

52I///////////////////////////////I42 

| 1 

53J local RIN pointer |43 

| 1 

54| |44 

55I JITJN |45 

56I job nane |46 

67| |47 

| 1 

+ + 

0|1:2:3|4:5:617:8:9|0:1:2|3:4:5 
111111 



60 



111111 
0|1:2:3|4:5:6|7:8:9|0:1:2|3:4:5 



61 1 JITCREC - t of creations 
| 

62 1 
63 1 



JITCPUC 
cpu nilliseconds 



P - Croup's hone volune is 
a private volune 

h - Private volune nounted 
(i.e. group bound to hone 
volune set), JITGIP = 67 



64 1 not used 



65 1 
66 1 




JITRIP 



67| 
70 1 

I- 
711 
721 

I- 
731 

I- 
741 

I- 
751 
761 
77 i 
1001 
1011 
1021 




JITGIP 



JITGIP 



(WTRBX 



3 |48 Recounting Info 

— I 
149 

— I 
150 
151 

— I 

1 52 HIPRI - highest job priority 

1 53 Recount 

1 54 Index Pointer 

— I 

|55 Group index pointer 

156 Systen volune set 

— | 

157 Group index pointer 

158 Nounted private volune set 
■ — I IWTRBX - tlounted Volune 

1 I59 Table Index 

—I 

160 
—I 



161 
1 62 
|63 

1 64 

1 65 

1 66 



0|1:2:3|4:5:6|7:8:9|O:1:2|3:4:S 
111111 



* THE F0RI1RT FOR UCRP (146-47) IS AS FOLIOUS: 

I I 

| 0| 1| 21 31 4| 51 61 7| SI 9|10|11|12|13|14|15l 

| 1 

U0RE1 |Sn|An|AL|GL|DIIOP|CV|uV|LGI//|PS|NA|NH|CS|NDISF| 

I— 1 

U0RD2 i |BB|IR|Pt1| I MR I |DS|PH| 

| 1 
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HlloH flask Fcrnat 



** The Allow M8k for HPE V it expanded to tin words. There it a nask in 
each user's JIT and the global allow nask in the SVSGLOB extension area. 
The Bllou Risk contain! enough bite for a one-to-one correspondence to 
every present OPERATOR type connand, or any future OPERATOR connand. Uhen 
* user is filLOUed any OPERATOR connand or RSSOCIflTEd to a device (Hhich 
will use OPERATOR type coiwands) then the corresponding bit(t) in the rtask 
in that user's JIT for that connand is set. If the HLLOU or ASSOCIATE Has 
done on a global scale, then the bit(s) in the naek of the SVSGLOB area 
is/are updated. 

The following EQUATES define the nask bit for each operator connand. 

The first set of connands define the operator connand* dealing uith 
devices. 

then adding a neu connand to this set of EQUATES, be sure to add a cor- 
responding ndve statenent in LGGMAGE, even if the connand uill not be 
logged. 





Ugrd 


Bit 


* 


IWIRTICI 











ACCEPT 





1 


1 


MM 





2 


Z 


GIVE 





3 


3 


HEfWFF 





4 


4 


headon 





5 


5 


REFUSE 





6 


6 


REPLY 





7 


7 


STARTSPOOL 





« 


8 


TAKE 





9 


9 


UP 





10 


10 


HP LINE 





11 


11 


DSCONTROL 





12 


12 


UPPER UHIT- 


>0EVICE COffllRNDS 




RBORTJOB 





13 


13 


ALLOU 





14 


14 


ALTFILE 





15 


15 


altjob 


1 





16 


BREAKJOB 


1 


1 


17 


DELETE 


1 


? 


18 


DISBLLOU 


1 


3 


19 


J06FENCE 


1 


4 


20 


UltlT 


1 


5 


21 


STOPSPML 


1 


6 


22 


SUSPENOSPOOL 


1 


7 


23 


OUTFEMCE 


1 


8 


24 


RECALL 


1 


9 


25 

G.01.00 
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Job Tlblll 








Uord 


aii « 


RESUflEJOS 




10 26 


RESUHE SPOOL 




11 27 


STREAKS 




12 28 


CONSOLE 




13 29 


IMtN 




14 30 


UELC0I1E 




15 31 


HON 




32 


noff 

YIMUNT 




1 33 

2 34 


untMT 




3 35 


LDISnOUNT 


2 


4 36 


MUECONTROL 


2 


5 37 


J08SECURITY 


2 


S 38 


OOUWLOAO 


2 


7 39 


BIOENABLE 


2 


S 40 


fllOOISRBLE 


2 


9 41 


LOG 


2 


10 42 


FOREIGN 


2 


11 43 


II1F 


2 


12 44 


shoucoii 


2 


13 45 


OPENS 


2 


14 46 


SHUTO 


2 


15 47 


DISCRPS 


3 


2 48 
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Job Tables 



Job Oirectorv Table (JOT) 



| 1 

I P.AX SEO SIZE(UOS) I 
| 1 

1 I POINTER TO JDSO I 
| 1 

2 I POINTER TO JTFO I 
| 1 

3 I POINTER TO JFEO. i 
| 1 

4 | POINTER TO JLEO | 
| 1 

5 I POINTER TO JJCU | 
| 1 

6 I POINTER TO FREE SPACE I 
| 1 

UORK AREA 

15 uords 

| 1 

in |ty| Nun | 

I 1 

I JSrtPIN | 

| 1 

JOB DATA 

SEGBENT DIRECTORY 

| 1 

I I 

JOB TENPORBRY 
FILE DIRECTORY 

I I 



1 entry per job 
OST t in uonl 10 
(bate 10) of PHGL08 



Job Tablet 

Job Data Sequent Directory Entry fin JOT) 

If l DST it allocated as (titrable, then it uill have entriet in both the JOT 
and PXFIX. Shareblt newt that it can be be ehared by all procttstt in tht 
Connand Interpreter proem tree (eont, etc.). Nonthareble OSTa only have 
entriet in the PKFIKED. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l 
|4|1 



SEGNENT ID 



EKTim DATA SEGNENT DST INDEX 



« OF PROCESSES ACCESSING 



job nunber 

nain process nunber 



NOTE: A return of 12004 in the BOO! value after using tht GETDSEG 
intrinsic indicates that there is no nore row in the Job Directory 
Table for another job sharable data segnent. 



Job Tenporarv File Entry fin JDT) 



1ENTRY INANE 

I SIZE (UDS)| SIZE (UDS) 



I- 



JOB FILE 
EQUATION TABLE 



JOB LINE 

EQUATION TABLE 

I I 

I I 

JOB CONTROL UORD 

TABLE (JJCU) 

I I 

I I 

I FREE SPACE I 

I I 



I I 

I I 

I I 

-I I I 

I I 

I I 

I I 

I I 



C1 


I 


C2 




CN 


I 


(MO) 


ENTRY 
INFORMATION 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
|..|-|--|--l-l--l-|-|--|-l-l-|--|-|-l--l 
I ENTRY SIZE (UOROS) I NANE SIZE (UORDS) | 
| 1 



KANE-ACTUAL FILE DESIGNATOR 

| 

I V0LU1E POINTER | 

| 1 

FILE LABEL POUTER 



Hene is a 

concatenation of up 
to three tubnanes. 
Bit of the first 
character of each 
subnane is 1. 



I 

The nane is a 

concatenation of up to 3 subnane*. 
Bit of the 1st character of each 
subnane is 1. 
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| 

Since all son processes of a CI share the sane JDT, exclusive access of the 

JDT is controlled uith the Job SIR (JIR) and is locked and unlocked by calls 
to LOCWIR and UNLOCKJIR. The JIR nunber is found in the PXGLOBAL area 
(JPCOUNT index). Only job and sessions traces have JIRs, systen processes do 
not, even though they have JOTs. The JDTs uere provided for systen processes 
for consistency, but are not Meant to be increased or reduced. 
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File Equation Table Entry (In JDT) 



1 2 3 4 5 6 ? 8 9 10 11 12 13 14 15 
|~|~|-l~l~l"l--|--|--|--|--|--l~l~l~l--| 
I ENTRY SIZE (UORDS) I NATS SUE (UORDS) I 
I , 

HflflE 
(FORUM. DESIGNATOR) 



I 

| 

I HRBE LENGTH (BYTES) I DEVICE LENGTH (BYTES) 



NAnE-BCTUAL DESIGNATOR 
(nay not be present) 



DEVICE/CLASS MfltlE 
(nay not be present) 



ROPTIONS 

I INIT RLLOC ID |T IS 



I • EXTENTS I////////I BLOCK FACTOR 
| 

! FILE 



-disposition 
BIT13 DEL 
BIT14 TEnP 
BIT1 5 SAVE 



SIZE 



FILE CODE 



I OUTPRI 
I- 



I 



I REF COUNT 
I- 



I • OF USER LABELS 



LANG (Native Language Support) 



LENGTH F0RnS=/Lfl8EL= 



FORtlS/LABEL 
ARRAY 
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JLEQ Entry (Cont.) 



25 

26 
27 
31 

331 

I- 
341 

I- 
35| 

I- 
36| 

I- 
371 

I- 
40| 

I- 
411 

I- 
421 

I- 
431 



NUHBER OF BUFFERS 
BUFFER SIZE IN UORDS 
INSPEED (2 Mords) 



OUTSPEED (2 uords) 
POLL REPEAT 



121 
-I 
122 



123 
-I 
125 



C TRACE INFO 
LOCAL ID PNTR 



127 
-I 
128 



129 
-I 
130 \ 



REtlOTE ID PNTR 
SUPUST PNTR 



PHONE LIST PNTR 



POLLIST PNTR 
HISC ARRAY PNTR 



131 
-I 
132 



133 
-I 
134 



REL TO ORIG 
OF LEQ ENTRY 



135/ 



Job Control Uord Table (JJCU) 



I NAI1E SIZE (BYTES) | 
I I 



-I 



I TY | 



HO0IFIER = VALUE FROd TO Z377777 



Nane nay be any alpha- 
numeric string, begin- 
ning uith an alpha, 
between 1 and 255 char- 
acters long. 

TY 00 = OK 
01 = UARN 

10 = FATAL 

11 = SYSTEn 
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Job Tables 



Job Line Equation (JLEQ) Entry 



I- 



I ENTRY SIZE (UORDS) I DESIG. SIZE (UORDS) I 



FORMAL 
LINE DESIGNATOR 
(1-4 UORDS) 



Ol 
| 

1 1 REF CNT 
| 

2 1 NANE LENGTH 
| 

3| 

I 

4| 



IP I 



PI1ASK2 



NAME 



( END OF LEQ ENTRY IF NON-BLANK ) 



-I 
I 

-I 

10 
-I 

11 P'FLAG 

2 

3 

|4 
I 



101 

i 
111 

I 
121 

I- 
131 

I — 



141 DRIVER NAnE LENGTH I 

151 

I 
161 

I DRIVER 

171 



201 

I- 
211 



221 

I- 
231 



no 
-i 

in 
-i 

112 
-I 

113 

I 

114 

I 

115 

I 

116 
-I 

117 
-I 

118 
-I 

119 



24 1 



— I 



1 20 



■—I 
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Job Tables 



OPTION UORD 2 
(ROPTIONS) 



I | 
I I 
|0 | 
I I 
I 
I- 



-I 
3 1 I copy 
' — I 



I — I 



I no-uait 



SI I 



SI 



Inulti- 
I access 



I — I 

7| | inhibit buff. 

I — I 
SI I 

I I exclusive 
9| I 
I— I 
101 
I- 
111 



Aoptions and Foptions Uord Breakdoun 



OPTION UORD 1 
(FOPTIONS) 

Ol— I 
I I 

I 

I o 

I— 

21 
I file type 

I— 

I I 

I— I 

SI IdisalloH files 

I — I 
61 llabelled tape 

i — I carriage 
7| (control 

I — I 



SI I 



I record fornat 



Jdynanic locking 

ifl'ulti- 
I record 



I— I 



I— I 
121 | 

I I 

I I access type 

I I 

I I 

I I 
151 I 

I — I 



I 



I default 
(designator 



I I 
121 I 

I — I 
13| lascii/binary 

I — I 
14| I 

I Idonain 
151 I 

I — I 
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Job Tables 



PHPSK Unrd Braaxdoun 



FILE TYPE 
LABELLED TAPE 

FRP.S HESSAK 

USER LABELS 

LAW 

VTERH 

POINTER EHTRV 

DYN. LOCKING 

UfllT.NOUAIT 

ItULTI ACCESS 

KUflCOP 

OUTPRI 

FILECODE 

FILESIZE 

NUflEKTS 

INIT ALLOC 



PDAS* UORD 2 

PHASK UORD t 

I 

— 10 

IBLOCK FACTOR 

— I 
IRECSIZE 

— I 

IDISPOSITION 
— I 

IHUH8UFFERS 

— I 

I INHIBIT BUFFERING 
---I 

I EXCLUSIVE 

— I 
ItlUtTI-RECORO 

— I 

I ACCESS TYPE 

— I 
|COPY,MOCOPY 

—I 

ICflRRIRDE CONTROL 

— I 

I RECORD FORHBT 
— I 

IDEFAULT DESIGNATOR 
—I 

IASCII/8INRRY 

— I 
lOOtlfilN 

— I 
IDEVICE 

— I 
INANE 

-I 
15 



1->info present 
0->info absent 
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UCOP Reouest OjBMi <DST*9) 

The UCOP Request Queue (URO) is used to to signal UCOP that a process is 
requesting process deletion. The URO is a circular queue using a FIFO algo- 
rithm to process requests. Uhen the next available pointer is equal to the 
next request pointer, then the table is enpty. Uhen the next available 
pointer is (logically) one less than the next request pointer and the request 
is entered, then the table is full. A full table uill cause Systen Failure 1 
(SF1). Thus, the last (logical) entry cannot be used. Rn entry is added via a 
call to REQUCOP. 

The UCOP Request Queue (flPE IV) uas previously used For nany functions such 

as stack expansion, but those functions noved to other areas uith nPE V. The 

only valid entry nou is a type 2 entry (process deletion). The original for- 
nat is retained in the event that rwre functions 2rt added. 



nfiXtt REO ENTRIES N/2 



TABLE RELATIVE POINTER TO NEXT AVAIL ENTRY 



TABLE RELATIVE POIHTER TO NEXT REQUEST 



REQ 1 



REQ2 



I I 



Job Tables 



UCOP Entry Fomat 



12-15 



uiiiiiiiiiiiniiiiiiHiiiiiiiiiiim 



i- 

I PIN 



Each entry is 
2 uords long 



2 process deletion 
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Relocatable Object Code 
CHAPTER 9 RELOCATABLE D8JECT CODE 
USL Files Introduction 



* USL record length 128 words aluays. 

* layout of doubleuord disc addresses 



I- 



-I 



| | UORD • I 

I 25-8IT RECORD H I UITHIN RECORD I 
| 1 

24 25 31 

* Hash links join all entries uith the sane hash key regardless of 

* Linear lists teminate uith a zero link 

* Circular lists containing only the list head point directly to 
thenselves. 

* Single-uord disc addresses 



I- 



9-BIT RECORD • 



| UORD * I 

| UITHIN RECORD I 



Uninitialized fields an reserved for future use and should 
be set to zero. 

Record and Overall USL File Fornat 



NOTE: 

0| LID I LOADER ID S.A. ■ Starting Address 

| 1 

1| NE | 1 NR. DIRECTORY ENTRIES 

| 1 

2| OL I 2 DIR. LENGTH 

| 1 

3| SUI1DC- I 3 TOTRL DIR. GARBAGE 

| 1 

4| NDG I 4 NR. DIR. GARB. ENTRIES 

| 1 

51 SABDL | 5 S.A. 8L0CK DATA LIST 

| 1 

61 SAIPL I 6 S.A. INTERRUPT PROC. UST 

| 1 

7| SBSL I 7 S.A. SEGflENT LIST 

| 1 

| 1 

10 1 FL |8 FILE LENGTH 
111 19 
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Relocatable Object Code 



USL Files General Infomation (Cont.) 



I I 
I RECORD I 
I I 
I I 
177 127 

200 128 

I I I 

I | DIRECTORY I 

i I I 

DL I ENTRIES I 

I I I 

I I I 

7 i 

I SAAD | I 

! | AVAILABLE I 

ADL I DIRECTORY I 

I I I 

SAI* 

I I I 

I I INFO I 

IL I (HEADERS) I 

I I (CODE) | 

I I I 

I I I 

I 
SAAI 

I I I 

AIL I AVAILABLE I 

I I INFO I 

I I I 

FL-1 

*SBI MUST BE ON A RECORD BOUNDARY 

NOTE: ALL ADDRESSES IH RECORD ARE UORD 
ADDRESSES. 
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I 

i 

! 

I 

I 

I 

I 

I 

I 
32K 
HAX 



Relocatable Object Code 



USL File Fornat (Cont.) 



I- 



-I 



12| SAAD I 



I- 



13| ADL I 



SAI 



I- 
141 
151 

I-- 

161 IL 
171 

| 

201 SAAI 

211 

| 

221 AIL 

231 

I 

24| TOTAL 
25| I.G. 

I" 

261 NIG 



I- 
271 



301 

I 

311 



321 

I 

331 



341 

I 

351 



361 

I 

371 



401 



411 HL | 



10 


S.A. AVAIL. OIR. 


11 


AVAIL. DIR. LENGTH 


12 

13 


S.A. INFO BLOCK 


14 
15 


INFO BLOCK LENGTH 


16 
17 


S.A. AVAIL. INFO 


18 
19 


AVAIL. INFO LENGTH 


20 
21 


TOTAL INFO GARBAGE 


22 


NR. INFO GARB. ENTRIES 


23 




24 




25 




26 




27 




28 




29 




30 




31 




32 




33 


HASH LINKS 



1771 HL 



I 94 | 



I 127 
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Relocatable Object Code 

USL Files General Infomation (Cont.) 



SASL- 



SEGL I 

I 

SEG.A | 



I 
I — 



->| SEGL 

I 

I SEG.K 

I 
— ISUBL 



SEG.B 



I I 
I I 
I I 



->l SUBL i 



I PROC.C I 

I I 

-I I — 



SU8LI- 
PROC.B | 



— ISECL 
| 

I 



I HAIN 



I I 



I I 

I I 

I I 

I I 



CIRCULHR LINK POINTS TO ITSELF 
IF LIST IS EHPTY 



SECL |- 



PROC.B | 
3 I 



I PROC. A 
I 1 



->| SECLI- 
I I 

IPAOC.fi | 

! 5 I 

i I 



A\ 

K >SEGflEHT NflllE ENTRIES 



PROC C \ 

PROC A > SUBPROGRAM 

HAIN / ENTRIES 



A \ 

3 I 
A I 

1 > SECONDARY ENTRY POINT ENTRIES 
A I 

5 / 
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Relocatable Object Code 
Data Descriptors, Passed Paranettrs 



1 2 3 4 5 6 7 9 S 10 11 12 13 14 15 

— I — l-l-t— i-l-i — l-l-l — I — I — t — I — I 

I nOOE | STRUCTURE I TYPE | 



NULL 







LOGICBL 


1 


1 


INTEGER 


1 


2 


IVTE 


1/2 


3 


REAL 


2 


4 


DOUBLE 


2 


5 


LONG 


3 


6 


COT" LEX 


4 


7 


LABEL (SPL) 




10 


CHARACTER (STRING) 


N/2 


11 


LRBEL (FORTRRN) 




12 


UNIVERSAL (HUTCHES ANY TYPE) 




13 


STRUCTURE 






SIBPLE VARIABLE 







POINTER 




1 


ARRAY 




2 


PROCEDURE 




3 


I100E 






NULL 







VALUE 




1 


REFERENCE 

WUIE 




2 
3 



Rslocatabli Object CoDi 
Entry Type 



GARBAGE 
1 

\7iT\" 



10 11 15 

NU - Nunber of words in this 

I I block 



GARBAGE 



NOTE: A descriptor of results in an automatic natch. 

Pascal 

Pascal sets the high order bit in the parameter type descriptor when 
it is generating hashed values. The renaining 15 bits tn based 
on a hash of the types of the paraneter. Only the Pascal conpiler can 
conpute the value, and the SEGHENTER nust natch the whole 16 bit value. 
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Relocatable Object Code 



Clarification Notes on Entry Types 2 and 4 
With Respect to SPL and FORTRAN 



•ENTRY TYPE 2 "ENTRY TYPE 4 «£NTRY TYPE 2 "ENTRY TYPE 4 
SPL 0.8. SPL PROC FORTRAN NAIN FORTRAN SUB. 



1,5 



TSDB 

kup'j: 



5 

NUSDB 



Tsoe 
aanjsT 



1,2,3,4 1,2,3,4 

TS08 TSOB 



NUPUST 

m 



NUPUST 
NUO 



TPDB = Total prinary OB length in words 
TSDS = Total secondary Dfi length in uords 
NUPUST = Nunber of uords in "TRACE" array 
NUSDB = Nunber of uords in secondary OB array 
NUO * Nunber of uords in oun trrvf 
KUD = Nunber of uords in data array 

1. Does not include the length of the STLT 

2. Does not include the length of the FLUT 

3. Does not include the length of any connon »rny 

4. Includes the length of any DB-allocated fomat »my 

5. Are not necessarily equal 



In general TPDB and TSDB are sunnations of storage allocated in the global 
area of the progran's data segnent. They are not, houever, conplete since 
the conpilers are not auare of all storage actually allocated! The STLT 
and FLUT are exanples of this since these tables are constructed by the 
segnenter. Connon arrays also present a problen since their inclusion in 
TPDB and TSDB night cause their storage requirenents to be counted nore 
than once. 



G.01. 00 
9- 7 



Entry Type 1 
SEGKENT NATS 
1 7 8 10 11 



//I 



NU 



I 1 I 



NU - Hunter of uords in entry 
block 



H L 



A I /////// 1 NC CHAR1 

(VARIABLE It'cttAR. SEE NC) 



I HL - Hash link - points to next 

entry having the sane 
I hash code 

I A - Activity bit 
I if active 
I 1 if inactive 

I (initialize to 0) 



L I 



SUSL 



CHAR. NC Ulllllllltllllin Note: An inactive segnent 

inplies that all entry 

SEGL | points are inactive 

I NC - Nunber of characters in 
nans. Rax is 16 



CHAR. 1 - First character in 

variable field 
CHAR. HC - Last character in 

variable field 
SEGL - Segnent link - points to 

next segnent nane 

entry 
SUBL - Subprogran link - points 

to next entry having 

the sane segnent nane 
L - Last entry in list 

if not last 

1 if last 
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Relocatable Object Code 
Entry Type 2 



OUTER BLOCK 
12345671 



//I 



HL 



A | C | I |///| NC | 



(VARIABLE II CHAR. SEE NC) 



i/////////////////// 



LI 



L I 



SECL 



RELATIVE TO SAI (SEE RECORD 0) 



F I U | 



TSDB 



NUPUST 



NUD/NUSDB 



T I 



NH 



RELATIVE TO SAI (SEE RECORD 0) 
I HDU 
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Relocatable Object Code 



Entry Type 2 fCont.i 



1 . 1 

1 . 

1 . 1 


I HDU | 


1 ■ 1 
I - 1 
1 ■ 1 


1 T | 


NH 1 


1 1 
1 SHU 1 
1 1 


1 HOU 1 


1 ■ 1 
1 ■ 1 
1 ■ 1 


I hdu i 



HU - Nunber of uords in entry block. 

HL - Hash link - points to next entry uith 
sane hash code. 

fl - Activity bit. if active, 1 if inactive 
outer block. 

C - Callability bit set if entry point is 
uncallable, 

I - Privilege node bit - set if prograti unit is 
to be executed in Privilege node. . 

NC - Nunber of characters in nane. Rax is 16. 

CHRR. 1 - First character in variable field. 

CHAR. NC - Last character in variable field. 

L - Last entry in list. 

if not last 

1 if last 
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Relocatable Object Code 
En;try Type 2 fCont.) 



SUBL - Subprogran link - points to next entry 
Entry having the sane segnent nane. 

SECL - Secondary entry point list link. 

SSfl - Progran unit starting PR address. 

SflC - Starting 8FILE9 address of code 
nodule 

F - Set if fatal error 

U - Set if nonfatal error 

NUC - Nunber of uords in code nodule. 

SE - Stack size estinate 

TPDB - Total nunber of uords of prinary 
OB to be allocated 

TSDB - Total nunber of uords of secondary 
D6 to be allocated. 

NU7UST - Nunber of uords in trace array 
(PUST) 

MO - Nunber of uords in data array 
(FORTRRN) 

NUSD6 - Nunber of words in secondary 
08 array (SPL) 

T - Terminating bit - set if last set of 
headers in entry 

NH - Nunber of headers 

SflH - Starting address of header (relative 
to Sfll) 



HDU - Header (pointer) 
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Relocatable Object Code 



Entry Type 3 

OUTER SLOCK - SECONDARY ENTRY POINT 
12 3 4 5 6 7 8 10 11 15 



Relocatable Object Code 
Entry Type 4 (Cont.) 



I//I KU 


1 3 1 


I HL I 


IMC I//I//I NC I 


CHRR 1 I 


I ■ I 
| (VARIABLE • CHAR. SEE HC) 1 
1 ■ 1 


| CHAR NC I////////////////////I 


1 L 1 SECL 1 


| SSR 1 



F I III 



Entry Type 4 



12 3 4S67 8 
-I--I--I--I 1- 



10 11 
— I — 



I//I 


Ml I 4 | 


1 HL 1 


IB | CI II H| NC 1 CHBR.1 I 


| (VARIABLE • CHAR. SEE NC) i 
I I 


I CHAR.NC 


Mlllilllllllllllllllllllllliin 


IL I 


SUBL I 


IL I 


SECL I 


| SSA I 



G.01.00 
S- 1i 



1PD6 
TSDB 



MIO/HUO 
P| NP I 



(VARIABLE # OF PRRHS. SEE CN) 
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Relocatable Object Cad* 



Entry Type a (Cent.) 



Hi - Nunber of uords in entry block 
HL - Huh link - point* to next entry uith sane hash code 
A - Activity bit. if active, 1 if inactive entry point 
C - Capability bit set if entry point ie uncallable 

I - Privilege node bit. Set if procedure it to be executed in privilege node. 
K - Hidden entry point. Set if entry point Hill not be in 

library directory. 
NT - Hunter of characters in nane. flax ie 16. 
CHAR1 - first character in variable field. 
CHAR NC - Utt character in variable field. 
L - last entry in list 

if not last 

1 if last 

5U8L - Suoprogran link. Points to next entry having the sane segnent 

Nam 
SECL * Secondary entry point list link. 
SSfl - Unit starting PB address 
SAC - Starting (file) address of code nodule 
F - Set if fatal error 

II - Set if nonfatal error 

NUC - Nunber of uords in code nodule 

SE - Stack aize estinete 

TP08 - Total nunber of uords of prinery OB to be allocated. 

TSOB - Total nunber of uords of secondary DB to be allocated. 

NUPUST - Nunber of uords in trace array (POST) 

we - Nunber of uords in data array (FORTRAN) 

NUO - Nunber of uords in oun array (SPL) 

P - Paraneter checker 

00 no checking. (Inplies HP undefined, FH and PARC's absent) 

01 check procedure type. (Inplies HP is undefined and PARITs 
absent) 

10 check procedure type and nunber of PARITs (inplies PRRITs 
absent) 

11 check procedure type, nunber of PflRH 's and type of each PARH. 
HP - Nunber of PARTI'S 

CN - Character count of PARITs 

TH - Terninating bit. Set if last set of headers in entry. 

NH - Nunber of headers 

SAH - Starting address of header 

HDU - Header (pointer) 



Relocattbie Object Code 

Entry Type 5 

PROCEDURE - SECONDARY EHTRV POIHT 
12 3 4 5(7! 10 11 



--I 

lit m 


— 1 1 

1 S 


HL 


«l C |//|H | NC 


I CHAR. 1 


(VARIABLE *CHAR! 


SEE NC) 


CHAR. NC 


Mlllltllllllllll 


L | SECL 


SSfl 
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NU - Nunber of uord* in entry block 

HL - Hash link - points to next entry uith 
sane hash code 

fl - Activity bit. if active, 1 if inactive 
entry point 

C - CaHability bit set if entry point is 
uncallable. 

H - Hidden entry point set if entry point 
uill not be in library directory 

HC - nunber of characters in nane, nax 

is 16 

CHfiR 1 - First character in variable field. 

L - Last entry in list 

if not last 

1 if last 

SECL - Secondary entry point list link 
SSfl - Unit starting PB' address 
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Relocatable Object Code 



Entry Type 6 
INTERRUPT PROCEDURE 



1 011 |Z 13 |4567|S 10111 1S| 


I//I 


NU I6| 


I HL I 


i« I IT 


I//I NC 1 CHAR.1 | 


1 (variable i char, see hc) i 


|A I IT 


I//I NC | CHAR.1 | 


! 


VARIABLE • CHAR. SEE NC) I 


! CHAR 


nc Miniiiiiiiiiiiiin 


1 IPL | 


1 DBS | 


1 SSA | 


1 SAC 1 


IF 1 U| 


NUC | 


IT 1 


HH | 


1 SAH ! 


1 HDU | 







Relocatable Object Code 
Entry Type 6 (Cont.) 

NU - Nunber of uords in entry block 

HL - Hash link. Points to next entry 

uith sane hash code 

A - Activity bit. if active, 1 if 
inactive entry. 

IT - Interrupt procedure type nunber 

NC - Nunber of characters in nane (naxinun is 16) 



CHAR 1 



First character in variable 
field. 



CHAR NC- Last Character in variable field 
IPL - Interrupt procedure link 

I storage 



DBS 



Hunber of uords of I 
required. 

SSA - Unit starting PB' address 

SAC - Starting (file) address of code 
nodule. 

F - Set if fatal error 

U - Set if nonfatal error 

NUC - Nunber of uords in code nodule 

T - Teminating bit. Set if last set 
of headers in entry. 

NH - Nunber of headers 

SAH - Starting address of header. 

HDU - Header (pointer) 
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Relocatable Object Code 



Entry Type 7 

BLOCK DRTR 

I I 1 | 2 I 3 |4S67|8 10|11 



— I- 


-1— 1 — 1 1 

Ml 


-1 

1 7 I 


I HL I 


I » I 


F 1 U I///I NC | 


CHAR.1 | 


I 
I 
I 


BLOCK ORTA HRfiE 




| CHRR.NC I///////////////////////I 


I BDL I 


I cm. I 


viittnttiiiim «c i 


CHSR.1 | 


i . i 

I cnniuiH RRRAY nrhe ! 

1 . 1 


I CHRR.NC Mlllillllllllllllllllin 


1 T 1 


HH 




I SRH 1 
1 1 


I HCtt 1 




1 


HOU 




1 ■ 1 
1 ■ 1 
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Entry Type 8 

PROCEDURE - SECONDARY ENTRY POINT 
1 2 3 4 5 6 7 S 10 11 15 



-l-l-l-l- 



lll\ 



R | CI//I HI NC | CHRR. 1 



(VARIABLE KHAR. SEE NC) 



CHRR. NC Mllllllllllllllllllll 



L I 



P I 



SECL 

SSR 
-I 

I 

TN 

PAM1. 1 



NU - NURBER OF UOROS IN ENTRY BLOCK 

HL - HRSH LINK - POINTS TO NEXT ENTRY 
UITH SBHE HRSH CODE 

R - ACTIVITY BIT. IF ACTIVE, 1 IF INRCTKE 
ENTRY 

C - CRLLR8ILITY BIT SET IF ENTRY POINT IS 
UNCRLLABLE 

H - HIDDEN ENTRY POINT. SET IF ENTRY 
POINT HILL NOT BE IN LIBRARY 
DIRECTORY 

NC - NUHBER OF CHARACTERS IN NARE. RAX 
IS 16 
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Relocatable Object Code 



Relocatable Object Code 
Entry Type 7 fCont. ) 



I 


CRL 1 


I///////////////I NC I CHRR.1 I 


I I 
| COmiON RRRRY HAKE 1 
1 - 1 


| CHAR.NC Ulilllllltllllllllilim 


1 T | 


NH 1 


| SAH | 
1 1 


I HOU 1 


1 
1 


ETC 1 



KU Nunber oF words in block 

HL - Hash link. Points to next entry with 
sane hash code. 

A - Activity bit. if active, 1 if inactive 
block. 

F - Set if fatal error. 

U - Set if nonfatal error. 

CHRR 1- First character in variable field. 

CHAR NC Last character in variable field. 

BDL - Block data link 

CflL - Connon amy length 

T - Teminating bit. Set if last set of 
headers in entry. 

NH - Nunber of headers. 

SRH - Starting address of headers. 

HDU - Header (pointer) 
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Relocatable Object Code 
Entry Type 8 (Cont.) 

CHRR 1 - FIRST CHARACTER IN VARIABLE UST 

CHAR NC - LAST CHARACTER IN VARIABLE 
LIST 

L - LAST ENTRY IN LIST 

IF NOT LAST 

1 IF LAST 

SECL - SECONDARY ENTRY POINT LIST UNK 
SSR - UNIT STRRTING PB" ADDRESS 

P - PfiRII CHECKER 

00 NO CHECKING (WPLIES NP UNDEFINED, 
TN AND PARHS ABSENT) 

01 CHECK PROCEDURE TYPE (IdPLIES NP 
IS UNDEFINED AND PARIS ABSENT) 

10 CHECK PROCEDURE TYPE AND NUHBER 
OF PARtlS. (IflPUES PARBS ABSENT) 

11 CHECK PROCEDURE TYPE, NUHBER OF 
PARHS AND TYPE OF PflRn. 

NP - NUHBER OF PRRtlS 

CN - CHARACTER COUNT OF PRRHS 

TN - PROCEOURE TYPE 
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Relocatable Objtct Code 



Entry Header Fornat 




HEADER 



CODE 



sah • 



->l HEADER 
| 

I 

I 
I 
I- 



I HESOER 



EACH ENTRY (EXCEPT SECONDARY ENTRY POINT ENTRIES) 
BAY DESCRIBE N> SETS OF HERDERS. THE HERDERS IN 
EACH SET I1UST BE CONTINUOUS RNO IN THE SAHE ORDER 
AS THE HOU LIST DESCRIBING THE SET. 

THE CODE NODULE HAY BE PLRCEO IN ANY POSITION IN A 
HEADER SET. NOTE THAT IF THE CODE NODULE IS RT THE 
BEGINNING OF A SET, SAC « SAH. 

IF THE ENTRY HAS NO HERDER SET, THEN NH, SRH SEQUENCE 
IS RBSENT. 
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Relocatable Object Codi 



Header Type 2 




P6A - PB' ADDRESS OF P8 RDD8ESS 
TO BE CORRECTED 

Header Type 3 

OUN/DRTA VARIABLES 
1 10 11 15 



l-l- 



I Bl 



PSA - PB' ADOSESS OF OUN VARIABLE 

POINTER TO BE CORRECTED 



Relocatable Object Code 
Header Type 

GARBAOE 

1 
|— | 



10 11 15 



I ///I 



I 



GARBAGE 



Header Type 1 

PCALo 
12 3 4 5 6 7 8 10 11 15 



in i 1 


PBA 




iiiiuiiun nc i 


CHAR. 1 




CHAR. NC Mlllllllllllllllllll 


P | NP | 


CH 


TH 


PARK. 1 




PARK. NP 



• PB' ADDRESS OF LINKED UST OF PCAL INSTRUCTIONS TO BE REPBIRED- 
LOUER 14 BITS USED AS NEGATIVE DISP. - BIT SET NEANS THAT 
THE UORD IS NOT A PCAL INSTRUCTION, BUT A POINTER TO A SST LABEL 
OF "EXTERNAL" FORHAI - R LINK OF TERMNATES THE LIST - BIT 1 
SET HEAHS THAT THE UORD IS TO BE INITIALIZED UITH THE PB ADDRESS OF 
THE PROCEDURE. 
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Relocatable Object Code 

Header Type 4 

DSDB/OUN/MTA/VALUES 
1 10 11 

l—l ,._ 

I///I NU | 



I S I 



INITIAL VALUES 



1 - LOGICAL UORO DISPLACENENT 

IN OUN RRRAY FOR IHITIRL VALUES 
- BYTE BIT-SET MPUES THAT LD IS 
TYPE BYTE AND THAT THE FIRST 
UORD OF THE IHITIRL VALUE BLOCK 
IS A COUNT OF THE RUBBER OF BYTES 
IN THE INITIAL VALUE BLOCK 

I - INTEGRATION NUI1BER - NUNBER OF 
TIHES THE BLOCK OF INITIAL VALUE 
IS TO APPEAR IK THE SECONOHRY BD - 
1->N0 DUPLICATION, 
Z->DUPUCATION, ETC 



Header Type S 

PUST 
1 



//I 



INITIAL VALUES 



P6' ADDRESS OF LINKED LIST OF 
POINTERS TO BE INITIALIZED UITH 
DB ADDRESS OF PUST (SAKE UST 
FORrtAT AS FOR FORHAT STRINGS) 
A PBA of -1 INDICATES NO FIX-UPS. 
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Relocatable Object Code 



NOTE: ALL REFERENCES TO THE PUST INCLUDE THE FDUR-UORO HERDER 
THAT IS APPENDED BY THE SEGtlENTER. THESE UOROS RRE NOT 
PRESENT IN THE HERDER; THEV RRE RUTOtlRTICALLY 
RLLOCRTEO RND INITIALIZED BV THE SEGHENTER. 

Header Type 6 

GLOBHL VARIABLES 



1 ; 
I--I 



10 11 
— I— 



TN 



DBA 



I/////////I NC 



I CHRR.1 
| 

I 
I 
I 
I- 



| CHAR. 2 



I CHAR. NC Ullllllllllllll 



Header Type 7 

EXTERNAL VARIABLES 
1 2 34 5 6 7 8 10 11 15 
//I NU | 7 



TH 



BI/////I NC | CHRR. 1 



I CHAR. NC Ulllllllllllllli 
I- 



I 



DA 



PBfl 



PBA-PB' address of linked lists 
of instructions to be repair- 
ed; louer 8 bits of inst. used 
as neg. displacenent to next 
instruction; a link of 
terminates the list. 

n -Ronitored variable bit; set 
if variable is being non- 
itored by debug. 

DA -Logical word disp. in PUST; 
loner 8 bits of uord uill be 
init. with prin.DB address 
of variable;DA is present 
if n=1. 

NOTE: PBA of -1 inplies null list 
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Relocatable Object Code 

Header Type 8 
PRIHRRY DB 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

I— l-l-l-l-l— I— l-i— l-l — I — I — l — l — l- 



l/l 



NU 



IUIU IU I U |U | U I U | U 
I Ol 1 I 2 I 3 | 4 | 5 | 6 | 7 



IU 
I N- 



IU IU |U |U Ulllllllllll 
S| N-4| N-3| N-2| H-U/t/l/ll/ll/l 



INITIAL VALUES 



U - ADDRESS BITS 

00 IF NO RODRESS 

01 IF HO ADDRESS 

10 IF UORD ADDRESS IN SECONDARY DB 

11 IF BYTE RODRESS IN SECONDARY DB 

N - NUPDB 

NOTE: INITIAL ADDRESSES THAT RRE 
SECONDARY DB ADDRESSES ARE 

RELATIVE (I.E., THEY ARE 
LOGICAL DISPLACEHENTS IN 
SECONDARY DB). 
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Relocatable Object Code 



Header Type 9 

CHITON VARIABLES 
12 3 4 5 6 7 8 10 11 15 



-l-l-l-l-l-l-l-l- 
//I 



Nil 



I 9 



NUC 



llllllin NC I CHAR. 1 



| CHAR. NC 



Ulllllllllllllli 



I Bl n| 
I 



I 






NL 
LD 
DR 
PBA 



I 

I 

I 

NL 

I 

I 

I 



Relocatable Object Code 
Header Type 9 [Cont. 1 

NUC - NUHBER OF UORDS IN C0I1I10N ARRAY 

NC - NUI1BER OF CHARACTERS IN COffllON 
NAtlE- IF BLANK COMHON 4 COM' 

DA - LOGICAL UORD DISP. IN PUST - LOUER 
8 BITS OF UORD UILL BE INIT. UITH 
PRIH. DB AODRESS OF VARIABLE - NOTE 
OB IS PRESENT IF n = 1 

B - BYTE BIT 

IF THE PRIMARY DB POINTER TO BE 
RLLOCRTEO AND INITIALIZED AND LD 
ARE OF TYPE UORD 

1 IF TYPE BYTE 

H - HONITORED VARIABLE BIT - SET IF 
VARIABLE IS BEING HONITORED BY 
DEBUG 

NL - NUflBER OF AODRESS LISTS FOR 
VARIABLE 

LD - LOGICAL DISPLBCEHENT OF VARIABLE 
IN COffllON ARRAY 

PBA - PB' ADDRESS OF LINKED LISTS OF 
INSTRUCTIONS TO BE REPAIRED 
LOUER 8 BITS USED AS NEGATIVE 
DISPLBCEnENT TO NEXT INSTRUCTION 
A LINK OF TERHINATES THE 
LIST 

PBA = -1 IHDICATES NO FIX-UPS 



I Bl til 



NL 
LD 



G.01.00 
9- 27 



G.01.00 
9- 28 



Relocatable Object Code 




BIT nW - BIT IMP OF LOGICAL UNITS 
REFERENCED; BIT 
CORRESPONDS TO LU 0, ETC. 
(1 LESS THAN OR EQUAL TO LU 
LESS THAN OR EQUAL TO 99) 



Header Type 11 



FORBAT STRING 

10 11 15 
|..| 1 ..| 

I//I NU I 11 I 
j 1 

I PBA ! 

j 1 

I NC . I 

j 1 

I CHAR. 1 | CHAR. 2 | 

IIIZIJ 

I CHAR. NX I////////////////I 



Relocatable Object Code 



»L Fjli Fprnat 



UD 
FL 
NS 



PBA - PS' ADDRESS OF LINKED LIST OF 
POINTERS TO BE INITIALIZED 
LOUER 14 BITS OF UORO USED 
AS NEGATIVE OISPLACEBENT TO 
NEXT POINTER - BIT SET 
WANS THAT THE POINTER IS TO 
BE TYPE BYTE - A LINN OF 
TERMNATES THE UST. 
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Relocatable Object Code 



Storage Hanaqanirtt 



FILE SPACE IS BANAGED IN TERHS OF 32 UOROS BLOCKS (4 BLOCKS PER 128 UORO 
RECORD). 



FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN A BIT HAP, UHICH IS PARTITIONED INTO 
RECORDS (2K BLOCKS PER SECTION). A INDICATES THAT A BLOCK IS USED, A 1 
INDICATES THAT IT IS FREE. 



FILE SPACE IS ALSO PARTITIONED INTO 512 RECORD SECTIONS (64 NAX. SECTIONS, 
2K BLOCKS PER SECTION, 1 HAP PER SECTION). THE NUKBER OF SECTIONS IN A FILE 
IS NS=(FL*S11) & LSR(3). THE FIRST NS RECORDS FOLLOUIHG RECORD (RECORDS 1 
TO HS) ARE RESERVED FOR THE SECTION HAPS. 



A COHPLETE FILE ADDRESS UOULO HAVE THE FOLLOUING CONFIGURATION: 



177 



SAUL 



LOUDER ID 

FILE LENGTH (IN RECORDS) 
NR. SECTIONS 

S.A. EXTERNAL SET LIST 





NS I 



I FREE BAP 
I HS-1 



NOTE: UNINITIALIZED FIELDS ARE 

RESERVED FOR FUTURE USE AND 
SHOULD BE ZERO. 



HS»1 



33 S.A. HASH UST 



1127 S.A. HASH LIST 94 
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Relocatable Object Code 



Entry Point Directory 



I HL |- 



1 2 3 4 S S 
| 1 

I I SECTION 



15 16 

--I — 

I 



26 27 31 
.... | 1 

I OISPLCBT | 



FILE (UORO) ADDRESS 
DOUBLE UORO 



//////// 
//////// 



->...—>! LINK 
| 

I USED 
| 

I 
I 
I 
I 
I 



Ultlllli 

Ulllllll 




THE DIRECTORY IS PARTITIONED INTO 95 HASH LISTS (SABE HASH FUNCTION AS USD: 
EACH HASH UST IS A LINKED UST OF RECORDS. 



EACH RECORD CONTAINS A SUCCESSOR UNK (RECORD ») AND A USED SPACE COUNT. A 
UNK OF TERBINHTES A UST. UHEN A RECORD IS VOID OF ENTRIES (USED=2), ITS 
SPACE IS RETURNED TO THE FREE STORAGE AREA. 
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Relocatable Object Code 



Typical Directory Entry 



1 2 3 4567 8 



... | .„i„. | ... | 1 1 

S I U I I I///I NC | CHBR. 1 | 




CHAR. 


nc uiiiiiiiiiuiiiiiiiim 


S.fl. INFO BLOCK I 


S.A. ENTR¥ i 


F I li I 


m CODE 1 


LC I 


HP I CN 




TN 1 


mm. i. i 






PBBtl. HP 1 



S - SECONDARY ENTRY POINT BIT - SET IF 
THE ENTRY POINT UBS ORIGINALLY fl 
SECONDARY ENTRY POINT. 

U - UNCBLLBBLE BIT - SET IF ENTRY POINT 
IS UNCBLLBBLE. 

I - PRIVILEGED nODE BIT - SET IF CODE 
IIODULE IS TO BE RUN IN PRIVILEGE ItOOE. 

LC is (0:2). ..Level of Checking 

= No checking 

1 >- Check for procedure type 
Z >- Check for # paraneters 

3 >= Check for paraneter type 
NP is (2:6) is # paraneters 
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Relocatable Object Code 



Procedure Infomation Block 
15 



NU INFO 



NU COOE 
* ENTRY POINTS 



CODE NODULE 



EHTN LINK 
TPDB 



TSDB 
NUSDB 



HEADER 
HEADER 



BLL HERDERS FOR THE PROCEDURE RRE APPENDED TO THE INFO BLOCK. THE 
HEADER SETS (EXTERNAL LISTS) ARE LINKED BY INCREASING FILE 
BODRESS; A LINK OF Z1 7777777777D TERMINATES THE LIST. 
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Relocatable Object Code 



Headers 
12 3 4567 8 10 11 15 



— I— I— 
tin 


I — I 1 

NU 


1 

I 1 


F I U | 


NU CODE 




S.A. INFO BLOCK 


S.fl. ENTRY 




PBA 




S I U | I 


I///I NC I 


CHAR. 1 




CHAI 


. NC Ullllllllilllllllllllll 


P I 


NP I 


CN 


TN 


PBRH. 1 






PAR". NP 





F - SET IF FATAL ERROR 

U - SET IF NON-FATAL ERROR 

S - SATISFIED BIT - SET IF EXTERNAL IS 

SATISFIED UITHIN RL. 
U - UNCHLLflBLE BIT 
I - PRIVILEGED BIT 



BLL HEADERS ARE THE SAHE AS ID A USL EXCEPT FOR THE PCAL HEADER. 
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Prepared Object Code 



0| FLAGS | 
| 1 

11 NS It 
| 1 

21 GS 12 
| 1 

3! SAG tt 
| 1 

4| SDS I 
| 1 

SI ISS 15 
| 1 

61 IDLS 16 
| 1 

7| HAXD |7 
| 1 

101 SHE IS 
| 1 

111 SSEG |9 
| 1 

121 SAOR 110 

I 1 

131 SASTLT |11 
| 1 

14| SAFLUT |12 
| 1 

15| sax |13 

I 1 

161 SSTT |14 
| 1 

171 SMC 115 
| 1 

20| SAPHAP 116 
| 1 

21 1 SASI 117 
| 1 

22I FLAGS2 119 
| 1 

23I CKSUI1 119 
| 1 

Z4| ISO 

| 1 

25I 121 

| 1 

26| 122 

| 1 



CHAPTER 10 PREPARED OBJECT CODE 
Proqran File Fomat 



NLH1BER Of CODE SEGHENTS 

GLOBAL SIZE (DB TO 01) IN UORDS 

GLOBAL AREA RECORD * 

SEGHENT SET RECORD * (EACH SEG. STARTS IN HEU RECORD) 

INITIAL STACK SIZE IN UORDS 

INITIAL DL SIZE IN UORDS 

HAX. DATA SEGHENT SIZE (OL TO Z) IN UORDS 

ENTRY POINT LIST RECORD It 

STARTING SEGHENT * 

PRIN. ENTRY PT PB ADDRESS 

06 BDR. OF STLT (-1 IF NO STLT) 

(STLT=Seqnent Length Table) 
06 ROR. OF FLUT (-1 IF NO FLUT) 

EXTERNAL LIST RECORD » 

PRIN. ENTRY PT SST « 

STARTING ADDRESS OF TRAPCOH' 

STARTING RECORD OF PHAP INFO 

STARTING RECORD OF SYHBDLIC ITEHS 

TOTAL CHECKSUM OF ALL SEGHENTS 

NOTE : ALL UNUSED UORD ARE RESERVED FOR 
FUTURE USE AND SHOULD BE SET TO 
ZERO. 
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Prepared Object Code 

Progran File Fomat (Coot.) 
I I 



| 1 

27| |23 

| 1 

301 124 

| 1 

311 125 

321 126 

| 1 



33 



127 
-I 



CST | CST | 
o I 1 128 \ 






1 


CST [III til 
n \llllll 


1 
1 


ISI SL 
1 1 o 


\ 
X 1 






ISI SL 
1 1 n 


1 



CST REHAPPING ARRAY 



SEGHENT DESCRIPTOR ARRAY 



-I / 



I I 



P-PRKILEGED HODE 

S-Sesrwt STT fomat: 0=> old fomat, 1=> neu (extended) fomat 

N'NS -1 

K=28 * (NS ♦!) 1 LSR (1) 

L=((28 * NS t (NS * 1)4LSR(1) ♦ 1271/128)128 - 1 
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Prepared Object Code 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
I-I-I-I-I-I-I-I-I-I--I — I — |— I— I— I— I 
IFIU |Z IP I//I//I I8A|IA|PH| | I I1RI///I DSI PH 



F - FATAL ERROR IN PROGRAH 
U - NON-FATAL ERROR IN PROGRAN 
Z - ZERO UNIT DL AREA 

P - SET IF ANY SEG IS PRIVILEGED NODE (IF NOT SET NORHAL= 
NONPRW IBOE) 



Prepared Object Code 

Flag$2 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
l-l-l-l-l-l-l-l-l-l-l— | — | — |— | — |— | 



ITIK | 



RESERVED 



I 



ACCESS TO 

GENERAL 

RESOURCES 



BATCH ACCESS (9) [BA] 

INTERACTIVE ACCESS (8) [IA] 

PRIVILEGED HODE (7) [Pfl] 



HULTIPLE RINS (4) [MR] 

EXTRA DATA SEGHENT (2) [DS] 
PROCESS HANDLING (1) [PH] 



T - PATCH AREA EXISTED IN ALL CODE SEGHENTS 
X - CHECKSUH VALID 



CST Renappinq Array 

CONTAINS THE LAST CST NUHBERS ASSIGNED TO THE SEGHENTS; 
INDEXED BY SEGHENT NUHBER. UHEN A PROGRAH FILE IS 
PREPARED, THE ARRAY IS INITIALIZED TO 0, 1....N. 
THIS ARRAY IS USED TO RE-ESTABLISH INTRA-PROGRAH 
LINKAGE UHEH THE PROGRAH IS LOADED. 

Sequent Descriptor Array 



CONTAINS THE SEGHENT LENGTH AND A FLAG INDICATING IF THE 
SEGHENT IS TO BE LOAOED IN PRH. HODE. INDEXED BY 
SEGHENT NUHBER. ALL SEGHENTS BEGIN ON A RECORD BOUNDARY. 
THE NUHBER OF RECORDS FOR A GWEN SEGHENT IS (SL * 127) 
1 LSR(7). THE RECORD NUHBER, SAS, OF SEGHENT N IS 

SAS:=0 

FOR 1=0 TO N-1 

BEGIN 

SAS:=SAS * (SL(I) • 127)iLSR(7) 

END 



Global Area Fomat 



A SET OF RECORDS CONTAINING THE INITIAL VALUES FOR THE 
GLOBAL AREA OF THE DATA SEGHENT. THIS SET BEGINS AT 
RECORD SAG (UORD 3) ANO CONSISTS OF (GS ♦ 127) 1 LSR(7) 
RECORDS. 
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Prepared Object Codt 



t»tiwHii un 



O 7 8 15 
— I— I 

///me i char i 




CHAR KC|//////// 


MR 


STT tt I SEC * 




STT « | SEC H I 


LCI HP | CN | 


TN | 


PARI1 1 | 






mm NP ! 



TVPICBL ENTRY 



CHECK 



112 



CHECK 3 



I LIST TEffillMRTEJt 



tC (0:2) = LEVEL OF CHECKING 

= HO CHECKING 

1 >= CHECK FOR PROCEDURE TYPE 

2 >= CHECK FOR * PflRffllETERS 

3 >= CHECK FOR PARAIIETER TYPE 

m = NUflBER OF REFERENCES 

M> (2:6) = NUnBER OF PflRffllETERS 



0.01 .00 
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Prepared Object Codt 



Prepared Object Codt 



Code Segnent Uith Patch Brea 



PATCH 
AREA 



Patch Area 





I PROGRMI | 
1 WME | 


I SEGflENT | 
1 NHflE | 


1 // 1 


1 CHECKSUN | 


I PREP TIHEI 


I PATCH TII1EI 


I PATCH | 
I AREA | 


1 PALEN ! 


1 STT i 



4-U0R0 PROGRAfl NAHE 

8-UORD SEGflENT NME 

1-UORD UNUSED 
1-U0R0 CHECKSUN 
2-UORD PREP TINE 
2-UORD PATCH TIKE 

1-UORD PATCH AREA LENGTH 
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Entry Point Lin 



////I NC I CHAR 1 




CHAR NC Mllllllll 


P.8. ADR 


STT • 


■ 


////I NC | CHAR 1 




CHAR NC I///////// 


P.B. ADR 


STT» 






LIST TERIIINATER 



NOTE THAT THE ENTRY POINT LIST HUST MHEOIATELY 
FOLLOU THE EXTERNAL LIST. 
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Prepared Object Code 
PHRP Inforwaticn 



PRBP Type Table 



PTTl 
IPRO 



LPRn 



PHBP TYPE TABLE 



SEGflENT PIMP POINTERS 



ACTUAL PIMP DATU1 



TYPE TABLE LENGTH 

LENGTH OF PIMP RECORO TYPE 

LENGTH OF PIMP RECORO TYPE 1 

LENGTH OF PIMP RECORD TYPE n 



NOTE : n • PTTL - 2 



G.01.00 
10- t 



Prepared Object Code 



PftAP Recorde 

Type Segnent PIW Record 

O1234567S9012345 



! Ol 


NC 


I 


char 1 | 




I char NC 




\l III III lilt III l\ 


I STT LEN 




I 


SEC MM I 


i SEG LENGTH ! 



Type 1 Procedure PHAP Record 

0123456789012345 



1 1 NC | char 1 



char NC 



Mllllllllllllll 



Wlllllllllllllllllllllllllllll 



Sfl OF CODE 



PRII1ARY ENTRY POINT ADDA 



COBOL TOOL BOX ID 
LINK 



TOOL BOX PROCEDURE ID 
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Prepared Object Code 

Type 2 Secondary Entry PHAP Record 

0123456789012345 



1 21 NC I char 1 | 


| charNC MIIIUIIIIUIIIX 


W\llllltl!lllllllllllllllllllll\ 


1 SECONDARY ENTRY POINT AODR I 
1 NUflBER OF ENTRY POINTS I 



H : HIDDEN ENTRY FLAG 
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Prepared Object Code 





1 

2 
3 
4 
5 
E 
7 

10 
11 
12 
13 
14 

41 
177 


LID I 
FL I 
EL I 

NSEG | 
| 

I 
FRTL I 

KRT I 

"S I 

HLO I 
HL94 | 



SL File Fornat 


1 FILE LENGTH (IH RECORDS) 

2 EXTENT LENGTH (IN RECORDS) 
3 

4 « SEGBENTS 
5 
6 

7 S.R. OF FREE R.T. ENTRY LIST (-1 IF NONE) 
S 

9 t* REFERENCE TABLE ENTRIES 
10 

11 * SECTIONS 
12 



Prepared Object Code 
SL File Fornat (Cont.) 



I I 

I RECORD I 

I i 

I I 



I 



I RECORD | < — REFERENCE TABLE POINTERS 



1 



I I 

I free nap | 

I I 

I I 



I I 

I FREE HHP I 

I NS-1 I 

I I 



SHADED AND UNINITIALIZED FIELDS ARE 
127 RESERVED FOR FUTURE USE RNO 
SHOULD BE ZERO. HL - HASH LIST. 
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Prepared Object Code 



Storaai Manaaansnt 



FILE SPACE IS MANAGED IN TEWS OF 12! WORD BLOCKS (1 BLOCK PER 12t UOAD 
RECORO). 

FREE SPACE (BLOCKS) IS ACCOUNTED FOR IN R BIT HAP, WHICH IS PARTITIONED INTO 
RECORDS (2K BLOCKS PER SECTION), A INOICRTES THAT A BLOCK IS USED; A 1 
INDICATES THAT IT IS FREE. 

FILE SPRCE IS RLSO PRRTITIOHED INTO 2048 RECORO SECTIONS (16 MAX. SECTIONS, 
2K BLOCKS PER SECTION 1 IIRP PER SECTION). THE NUMBER OF SECTIONS IN fl FILE 
IS HS«(FL t 204?) & LSR(7). THE FIRST HS RECORDS FOLLOUING RECORDS 0, 1 
(RECORDS 2 TO NStl ) ARE RESERVED FOR THE SECTION HRPS. 



IF THE SECTION IMPS SPECIFY MORE SPRCE THRN IS POTEHTIALLY AVAILABLE, 
RECORDS BEYOND FLWIT ARE NARKED RS "USED". 



Entry Point Directory 



THOSE 



I HL |- 



->| LINK 
| 

I USED 
| 

I 
! 
I 

miiiiiiii 
Minimi 



■> >| LINK 



I- 
I USED 
| 

I 



Minimi 
Milium 



■>— ->i i 
i 1 

I USED I 
| 1 

I I 

I i 

| 1 

Mtmtiin 
Mimiiin 



THE DIRECTORY IS PARTITIONED INTO 95 HRSH LISTS (SANE HASH FUNCTION AS USD; 
EACH HASH LIST IS A LINKED LIST OF RECORDS. 

EACH RECORD CONTAINS A SUCCESSOR LINK (RECORD •) AND A USED SPACE COUNT. A 
LINK OF TERMINATES A LIST. UHEN A RECORO IS VOID OF ENTRIES (USE0*2), ITS 
SPACE IS RETURNED TO THE FREE STORAGE AREA. 

THE HASH LIST HEAD POINTERS (HL IH THE DIACRAD ABOVE) ARE IH RECORD UORDS 
Ml TO 1177. 
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Prepared Object Codt 



Typical Directory Entry 



12 3 4 


5 E 7 8 


i 10 11 12 13 14 15 


lll\ U I///I P 1 


NC | 


CHAR 1 I 




CHAR NC 


Miiimmiuumuiiiiimiin 


STIR 


i 


SEC* I 


IX | HP 


i 


CN I 


TN 1 


FORM ! 


: | 


PARfi NP | 



LC is (0:2)... Level of Checking 

» No checking 

1 >« Check for procedure type 

2 >' Check for # paraneters 

3 >■ Check for paraneter type 
NP is (2:6) i> # paraneters 

P - s Not pemanently allocated 
1 s Permanently allocated 

U - Uncallable bit - set if entry 
point is uncallable. 
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Prepared Object Code 



Code Seqnent Linkage Structure 



I CODE SEGMENT | 



Prepared Object Code 

Code Seqnent Structure (Cont.' 

1 2 3 4567 S 15 

l-l-l-l 1 



I I 

I STT I1AP ARRAY | 
I I 



I EXTERNAL LIST I 



EACH CODE SEGMENT OCCUPIES AH INTEGRAL NUH8ER OF RECOROS. THIS BLOCK OF 
INFORMATION CAN BE SUBDIVIDED INTO THREE TABLES: THE CODE SEOtlENT PROPER, AN 
STT SEGtIEHT HAP ARRAY, ANO AH EXTERNAL LIST. 



STT HAP ARRAY 

A 1 BYTE H 256 BYTE ARRAY. IT IS INDEXED BY STT NUMBER AND RETURNS (IF THE 
STT CORRESPONDS TO AN EXTERNAL OF THE SEGMENT) THE SEGTIEHT NUMBER OF THE 
EXTERNAL AND 255 OTHERWISE. THIS ARRAY IS USED UHENEVER THE SELVTENT IS 
LOADED AND IS UPDATED UHENEVER THE SL IS BOUND BY THE SEGMEHTER. 



EXTERNAL LIST 

R SYMBOLIC LIST OF THE EXTERNALS OF THE SEGMENT. EACH ENTRY CONTAINS 

IHFORHATION ABOUT THE EXTERNAL: PARAHETER CHECKING LEVEL AHD PARAMETER 

HATCHING IHFORHATION, AND THE SEGMENT NUIIBER AND STT NUMBER IF THE EXTERNAL 
IS SATISFIED UITHIN THE SL. 



CODE SEGMENT 



SI/I/I/I NC | CHAR. 1 



CHAR. NC Mill III I llll 



STT « | SEG. N 
P I NP | CN 



S - SATISFIED BIT - SET IF EXTERNAL 
IS SATISFIED UITHIN SL 
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EXTERNAL LIST TERMINRTOR 
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Prepared Object Code 



Reference Table Structure 



FDR EBCH SEGMENT THERE IS B REFERENCE TABLE ENTRY OF 32 I10RDS. THE REFERENCE 
TABLE ENTRIES ARE PACKED FOUR TO A RECORD. THE RECORDS CONTAINING THE 
REFERENCE TABLE ENTRIES ARE LISTED IN RECORD 1. THE RECORD CONTAINING 
REFERENCE TABLE ENTRY N IS REC 1 (N.(0 : 14)); THE FIRST UORD OF THE ENTRY IS 
REFTBB (N. (14 : 2) & LSL (5)}. 

UHEN B SEGMENT IS DELETED, THE REFERENCE TABLE ENTRY CORRESPONDING TO THE 
SEGBENT IS RELEASED. THESE FREE ENTRIES ARE LINKED TOGETHER IN B LIST; THE 
SEGTIENT # IS USED AS B LINK AND IS PLACED IN THE FIRST UORD OF THE ENTRY. 

UHEN B SEGTIENT IS BODED IT IS ASSIGNED A SEGMENT NUH8ER (0 LESS THAN/EOUHL TO 
N LESS THAN/EOUHL TO 254); THE NUMBER IS THAT OF THE FIRST FREE REFERENCE 
TBBIE ENTRY, OR, IF NONE ARE FREE, THE NEXT AVAILABLE REFERENCE TABLE ENTRY 
(CRUSING SPACE BLLOCBTION FOR THE ENTRY). 
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Prepared Object Code 




(FILE REC1) (1 SECTOR) 

SEG.NAI1E -16 BYTE ARRAY 
UITH NO CHARAC- 
TER COUNT AND 
TRAILING BLANKS 
ADDED. 

REF.tlBP -256 BIT ARRAY 

(INDEXED BY SEGK); 
BIT SET IF SEG IS 
REFERENCED DIRECT- 
LY OR INDIRECTLY. 



Reference Table (256 Maxinun Entriee) 

TYPICAL ENTRY 
REC. 0123456789 15 Z 



1 
2 
3 
4 
5 
6 
7 
10 



SEGMENT DELETED 
EXTERNAL SATISFIED 
PERMANENTLY ALLOCATED 
CORE RESIDENT SEGI1ENT 
KPE SEGTIENT 
PRIV.INST. IN SEGTIENT 
SLSEGFLAG 
PATCH FLAG 
CHECKSUH FLAG 



SLSEGFLAG: 

= => SEG STT IS IN 
OLD FORtlAT 

= 1 => SEG STT IS IN 
NEU FORMAT - 
EXTENDED CSTS 



-l-l-l-l-l-l-l-l-l 

PIN I SEGTIENT LENGTH 




SEGMENT ADDRESS (REC. 


«) 


• REC'S FOR SEG. 1 EXTN 


LIST 


F|SI/i/|A|C|X|/i/| « ENTRY PTS. 


SAPKAP 


SASI 


T|K| 


SI LENGTH 



REFERENCED SEGTIENTS 
BIT TlflP 
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Prepared Object Code 



Code Seqnent Uith Patch Area 



Prepared Object Code 

PMAP Information 



PATCH 
AREA 




I STT | 
I I 



PIMP Type Table 



SEGMENT 
NAME 



// 
CHECKSUM 



PREP TIME 
3 RTCH TIME 



PATCH 
BRER 



8-UORD SEGMENT NAME 

1-UORD UNUSED 
I -UORD CHECKSUM 
2-UORD PREP TIME 
2-UuRD PATCH TIME 



1-UORD PATCH RRER LENGTH 



LPRO 
LPR1 



PMHP TYPE TABLE 



ACTUAL PHBP DATUM 



TYPE TABLE LENGTH 

LENGTH OF PMAP RECORD TYPE 

LENGTH OF PHBP RECORD TYPE 1 



LPRn | LENGTH OF PMAP RECORD TYPE n 

NOTE : n <= PTTL - 2 
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Prepared Object Code 



Type Sagtient PHRP Record 

01Z34S67S901234B 



Ol 


HC 


I 


char 1 




char NC 




Milllllllltllll 


STT UN 




I 


SEG NOT 


SEG LENGTH 





Type 1 Procedure PtlAP Record 

0123456719012345 
1 1 NC I Cher 1 



Mill! Illll I mi 



*\lllllllllllllllillltlllllllll 

SB OF CODE 



CODE LENGTH 
PRIHRRY ENTRY POINT HDDS 



COBOL TOOL BOX ID 
LINK 



TOOL BOX PROCEDURE ID 
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Prepared Object Cede 

Type 2 Secondary Entry PfflP Record 
012345(7)9912345 

21 NC I char 1 ! 



char NC Ullllllllllllll 

H I ///////////////////////////// 
SECONDARY ENTRY POINT RDOR 
NUMER Of ENTRY POINTS 



H : HIDDEN ENTRY FUG 
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Loader 



CHAPTER 11 LPHPES 
HPE Loader 



The loader is a systen process uhich will do loads sequentially. If a process 
needs code to be loaded, it uill get the load process 1 SIR, fill loader can- 
nunication table, and then awake the loader. Upon conpletion, the loader uill 
return its status through the loader connunication table, and then activate 
the waiting process. 



Loader Seqnent Table Overview 

Loader Segnent Table consists of tuo DST's. The nain one is DST 122 (LST). 
The other DST (XLST) has its DST nunber stored in SYSGLOB Z226. 



PRIrtflRY D5 RREfl 



LOBDER COrMNICRTION 
TABLE 



SBUF (12S uords) 
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Loader 
»WT "v«r;eu 



DB | 






PRIIWRY DB RREfl 


DB»7 -->| 


SSUF (128 uords) 


DB+O -->| 






DIRECTORY 


r I 





The above DST's has exactly the sane prinary DB area so that directory entry 
handling procedures can be used on both DST'S. XLST is the LST extension and 
is used to store the extension entry only. Uhen an extension entry is 
needed, it is copied into the LST to elininate frequent EXCHANGEDB. Note that 
XLST is capable for any types of entries. It is used for extension entry only 
for now. Also, sone of the prinary DB's in the XLST are not used. They are 
there just for the consistency. 
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Loader Seqnent Table Prinary [ 



4 | ENTP1 
| 

5 1 ENTP2 



mm i 
I 

DIR LFH | 

SLOT 
ENTP 



161 

I- 
171 



ENTP3 
eSBUf 



211 

I- 
221 



23! 



SO 
SP 
SO 
SR 
SS 
ST 



Loader 

Directory Entries 
0| ii 2] 3i 4| 5j 6i ?i SI 9|10|11|12|13|14|15| 



-l-l-l-l-l-l-l-l-l- 
FORURRD LINK 



-l-l-l-l- 



24|HDFULINK(TYPE 0) 
| 



101 

I- 
111 

I- 



SJ 

121 SK 
| 

131 SL 



| 

|HDFUUHK(TYPE 8) 



|HDFJKLINK(TYPE 0) 
| 



|HORKlINK(TYPE 8) 
| 



I 



EMTPn : POINTERS POINT TO THE CURRENT ACCESSED ENTRY. 

SBUF : UTILITY BUFFER. USUALLY CONTAINS PROGRAM FILE RECORD 

INFORnATION. 
SI ST : UTILITY 08 RELATIVE VARIABLES. 
HDFUUNKs : HERO OF FORURRO LINK FOR ERCH TYPE. 
HDBKUNKs : HERO OF BflCKURRD LINK FOR ERCH TYPE. 



BRCKMARD LINK 
LENGTH 



0| 1| 21 31 4| S| 6 7| 8| 9110111 |12|13|14|15 
.-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 



FORURRD LINK 
BRCKURRD LINK 



FILE DISC RODRESS 



* ALLOCATED SEE 



I « SEGUST ENTRIES 



SEG RRRRY ( 16 UORDS ) 
LOG SEG RUBBER I 



IR IC IX in 



REFERENCE COUNT 
PHYSICAL CST NUBBER 



GRRBRGE(O) 



SL FILE(1) 



SEGLIST BRRRY 
3 UORD ENTRY 
PER RLLOCRTED 
SL SEG 
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Uasisa.ssuia.Km-.i 

01 1| 21 31 4| 51 SI 71 II 9I10I11I12I13I14I15 


LMftr 

PROORAH 
FILE (2) 

\ 
I 
I 
I SL INFO AREA 

> 19 UORD PER 

I EACH SL FILE 

I 

I 

/ 

\ 

I PSEGHAP 

> ARRAY 

/ 


Lo#dtr 

Directory Enlriii (Com. ) 

I Oj 1j 2| 3] 4| 51 6] 7{ S| 9|10]11 [12113114115 


UMOINGO) 


FORUARO LINK 




I FORUARO LINK 


BACKUARO UNK 
LENGTH 


I BACKUARO LINK 


i LENGTH 


P |A 1 I UB I 2 


IP I I 3 


FILE DISC ADDRESS 


! FILE DISC ADDRESS 


CST BLOCK INOEX 




SEGIfflP DST 




• PROCESS SHARINS 
• SEG III PROGRATI FILE I II SUHFO AREA 


PV FILE INFO 
TWICE EXTERNAL PLABEL 




0| 11 21 31 4| 51 61 7| SI 9|10|11|12|13|14|15 


UAITER(4) 


FORUARO LINK 


SL SEARCH SEQUENCE 


BACKUARO UNK 


SL FILE DISC ADDRESS 


LENGTH 


PI 14 






LIB SEC ARRAY (16 UORDS) 



FILE DISC ADDRESS 




: 


UNITING PIN 




UNUSED 








PSEGNIP SIZE 
LIB LOG SEO | SL INFO INOEX 


G.01.00 
11- 6 


LIB LOG SEG | SL UFO INOEX 








UB LOG SEG I SL INFO INOEX 
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Directory Entritt (Cont. ) 
0| 1| 21 31 4j 5| 6| 71 81 9|10|11 |1Z|13|14|15 


Loadtr 
L0A0C0(5) 


LOK 


hr 

Directory Entrie. (Cont. 1 

0| 1| 21 31 4| 51 6| 7| S| 9|10|11|12|13|14|15 
-|_|_|_|_|_|_|..|_|„|_|_|_|_|_,_ 

FORUARO LINK 
BACKUARO UHK 


EXTENSION!?) 

\ 
1 

1 

> T1CSTREF ARRAY 

1 

1 
/ 


FORUARDUNK 


BACKHAND LINK 
LENGTH 
PI I 5 


LENGTH 


I UB | 7 
PIN 


FILE DISC ADDRESS 


EXTENSION ID 


LOAD PROCESS STATUS 


LOAOPROC COUNT(LOAOPROC)/LOG SEGH(ALLOCATEPROC) 






P LABEL 


Ol 11 2| 31 4| 5| 6| 7| S| 9|10|11|12|13|14|15 


SHARER(6) 


« CHHH IN NAht | 


FORUARO UNK 


PROCEDURE NAHE 


BACKUARO UNK 


LENGTH 


I • SL INFO AREA 


PI I 6 


SL INFO AREA (19 UORDS PER SL INFO ENTRY) 


PIH 


FILE DISC ADDRESS 


NCSTREFSHE 
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N I | HCSTIOXO) 




I 


N 1 | nCSTIDX(n) 
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Directory Entries (Cont,) 



C| 11 2| 3| 4| 51 6| 7| SI 9|10|11 |12|13|14I15 
FORURRD LINK 



BflCKUBRD LINK 
LEMGTH 



LOBOPROC 
HASTER(8) 



PIN 



» SLID ENTRIES I « ACTIVE LOBDPROCS 



EXT IDX TABLE (16 UORDS) 



BCST IOX TABLE (16 UORDS) 



SLID(1) 



SLIO(n) 

| (tnCST LOGSEG SIZE 



LOG SEG « I SLID IM)EX(1) 

REFERENCE COUNT 



LOG SEG « I SLID INDEX(n) 

REFERENCE COUNT 



\ 

I 

| REFERENCED 

> SL ARRAY 

I 
! 
/ 



HCST LOGSEG 
> ARRAY 
2 UORDS PER 
ENTRY 
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Loader Connunication Table f LCT1 



Fom Incofiinq to Loader (Load/Allocate Proqran) 





0| 1| 2| 3| 4| 51 6| 7| S| 9i10|11|12|13|14|15| 





CUD I LIB I BILOI L| \llllllliillillillllilli\ 


1 


PIN I 


z 


LDEV 


I i 
1 I 

DISC ADDRESS I 


3 




4 






5 






6 






7 




UNUSED I 


8 






9 






to 






11 


UBITER PCB 


INDEX ! 


12 


IBBIIBIPnl |BR| |DS|PH| 


13 






14 


GROUP 




15 




NABE i 


16 






17 






1! 


ACCOUNT I 


19 




NAI1E 


20 






21 


PV INFO 



CBO=loader end 
O-load prgn 
1=load proc 
2=alloc prog 
3=alloc proc 

U8=library 
search 
0=SYS 
1=PUB 
Z^GROUP 



fl=NONPRIV MODE 
LD=LOBD DOBBIN 
L=LOBO BAP SES. 



USER CAPABILITY 



Loader Cache 



SYOLOB extension area ♦ 172 contains DST nunber oF cache 
BUCKETSIZE = 252 



Cache Data Sequent Fomat 



01 I 

1 1 HIT COUNTER I 



21 



3 1 HISS COUNTER | 

4 1 BUCKET | 

4* BUCKETSIZE I BUCKET1 I 



4t94* BUCKETSIZE 



4*95* BUCKETSIZE -1 ! 



Bucket Fornat 



| Length of | 
I SLDIR1 t1 I 

1 I SLOIR 1 I Host recently referenced systen SL 

I I directory entry fron this SL directory 

j | bucket 

| LENGTH OF I 

I SLDIR2 ♦ 1 I 

I SLDIR 2 I Second nost recently referenced entry 

| LENGTH OF I 

I SLDIRN ♦ 1 | 

BUCKET | SLDIRN I Nth nost recently referenced entry; if 

SIZE-1 1 1 not conplete then indicates end of 

bucket 
All bucket uords are initialized to BUCKETSIZE ♦!, indicating 
no entries. 
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LET (Cont.) 



Fom Inconinq. to Leader (Load/Allocate Procedure) 





0| 1| 21 31 4| 5| 6| 7| 81 9110111 |12|13|14|15| 





CUD | LIB I HILDI LI UlllllllllltllliillUin 


1 


PIN I 


2 


EXTENSION ID I 


3 


• CHAR IN NAnE I I 


4 




5 




6 


PROCEDURE NANE I 


7 




8 




9 




10 




11 


UAITER PCB INDEX I 


12 


|6A|IA|PK| INRI IDSIPHI 


13 




14 


GROUP I 


15 


NRHE ! 


16 




17 




18 


ACCOUNT 


19 


NRI1E 


20 




21 


PV INFO 



CHD=loader end 

O-load prgn 
1=load proc 
2=aIloc prog 
3-alloc proc 
UB=library 
search 
0=SYS 
1=PUB 
2=GR0UP 



H=NONPRIV (10DE 
L0-U3AD OOBAIN 
L=LOBD BAP REO. 



USER CAPABILITY 
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Loader 



U=T (Cant.) 



fern Returned (Ho Error) 



, 

II I IV | STARTING SEGHEHT HDWER I 

■ , 

LORD HAP FLAG 1 
1 

LDEV | 
1 1 

DISC | 



ADDRESS 



TRACE LABEL (If TRACE) 



Forti Returned (Error Occurred) 



I 
I- 

1 I 



FILE SVSTEO ERROR It 
LOADER ERROR « 



Loader 



Looicel Seanent Transfer* Title (LSTT) 



Wwi 1 proem refarencee any ueer SL aegnents, then eegnenta ire aeeigned 

logical aegnant nunbera if the niu napping ucodi la running. The LSTT 
providee a nap napping then logical eegnenta into thair physical aagnant 
mint-are and having true STT'a for the napped aegnents. The LSTT ia created by 
LOUDER during the load tine. It occupiae an DST and the DST nunber la atored 
in PC805). If no uaer SL aegnant ie referenced, the LSTT uill not be needed, 
hence it uill not be created. 

The neu napping nicracode depende on the existence of the LSTT for getting 
the physical aegnant nunber for a napped aegnant. So the LSTT hat to be in- 
cluded in procaaa' locality liat if there ia an LSTT. Diapetcher uill than 
bring the LSTT in before the procaaa can be run. Alao the bank and addreae 
for the LSTT belonging to the currant running procaaa are atored in ayagiob 
cella ( 1221 and X222 ) during the launch tine by the dispatcher. These cella 
are used by Microcode for fast accessing the LSTT. 
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Logical Saonent Transfom Table (LSTT) (Com.) 



Logical aag 1 
Logical seg 2 



Logical aeg n 
(lUx 2SS) 



STT'a for logical 
segnent 1 
(if needed) 



1 V of Logical Stgncnts I 


1 Length of LSTT I 


1 Physical Segnent It | 


1 Pointer to STT list 1 


1 Physical Segnent II 1 


1 Pointer to STT list I 




1 Physical Segnent It I 


|HI 


Pointer to STT liat | 
STT * | SEG II | 


mi 


STT • | SEG » | 




mi 


STT • I SEG • 


... 


Total STT'a for this sag I 


ini 


STT * | SEG II \ 


mi 


STT a | SEG II I 




mi 


STT • | SEG II 1 


1 Total STT's for this seg I 



STT's for logical 
segnent n 
(if needed) 
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CHAPTER 12 PRWBTE VOIUIIES / SERIAL CISC 



Mounted Volune Table fnVTBB) 
OST =53 =165 
SIR =27 =133 



111111 
0|1:2:3|4:5:6|7:8:9|0:1:2|3:4:5 



I- 
Ol entry size : nax entries I 

| 1 

1 1 tt of Mounted volutie sets I 1 

| 1 

2 1 Idev : DIRBflSE I 2 naster volune of 

| -| SVS VS is always 

3 1 of SWTEtl volune set I 3 ldev = 1. 

| j 

4| I 4 

| j 

5| I 5 

| 1 

I I 



171 

I- 
181 



191 

I- 
20| 



121 
-I 
122 



123 
-I 
124 



— entry 
(IWTBBX = 0) 
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I1VTBB (Coot.) 



| 1 

0|1 Icycl I Dircsize/32 I 

| 1 

1 | hvol j nvol I ucnt I 1 

I 1 

2 1 ldev : DIR8BSE | 2 

| j 

3 1 of volune set I 3 

| 1 

4) generation nunber I 4 

| 1 

5| ldev VTBBX I 5 I 

j j j- vol entry 

6| dbns : vent I 6 I (double) 

| 1 

I I 



191 



ldev 



-I 

123 



201///////////////: 



124 



vol entry 7 
(double) 



- entry n 
(IWTBBX = n) 



cyd - cyclical volune index 
(local VTBBX) for disc 
space allocation 

hvol - highest (ordinal) volune 

index (volune index being the 
volune set's local VTBBX) of a 
nounted nenber of the volune 
set(class). 

nvol - tt of volunes nounted for the 
volune set (class). 

ucnt - tt of users having Mounted 
the volune set. 

dbns - directory bit nap size 
(sectors). 

vent - t of users having nounted 
the volune. 
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HVTBB (Cont.) 



0|1 Icycl I Dircsize/32 



ucnt 



| DIRBBSE 



11 hvol I nvol I 
| 

21 ldev 
| 

31 of volune set 
| 

4 | generation nunber 




1 

2 naster volune 
of volune set 

3 is on this ldev 



I 4 



ldev 
dbns 



VTBBX 

vent 



I 5 I 
-I |- vol entry 
I 6 I (double) 



ldev 



///////////////: 



I23 I 
-| |- vol entry 7 
|24 | (double) 



- entry 1 

(nvTBSx = 1) 



-- entry n-1 
(IWTBBX = n-1 ) 
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Private Volun 

111111 
0|1:2:3|4:5:6|7:8:9I0:1:2|3:4:5 


Use 


Table fPVUSER 
DST =54 =266 
SIR =29 =235 







table size (words) 


1 
2 

3 

4 




1 


tt of entries 




2 


bitnask of nVTRBX's represented 


— table head 
(5 uords) 


$3 


naxinun table size ( uords ) 


4 


available pointer 






op Mask I1VTRBX 




- entry head 
(5 uords) 

- user entry 1 

- user entry 2 






mx users 






It pins 






current size of entry 




* 


PV Flags |0P 






vnask 








pin 






user bind count 






user Mount count 






systen bind count 






systen nount count 






bind nanes count 






DST tt of bind nanes segment 






vnask 








pin 


— volune set 
entry 1 
trWTRBX = j) 




user bind count 




| user nount count 




systen bind count 






| systen nount count 
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m m tou 



bind nam count 




- user entry n 


DST H of bind uw tegntnt 


vnwk 


pin 


user bind count 


iner nount count 
systen bind count 
aytttn twunt count 


bind nwt* count 


DST * of bind tunc* •tgntnt 




' VOlUflt Mt 

entry n 
(WTRtW * k) 



b 
1 

l 


1 
1 
1 

1 
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Bind Sail Dm Saanont 
(Created ami nanaged via WISER Table) 



111111 
0|1:2:3|4:5:6|7:S:9I0:1:2|3:4:5 



new eegnent length 



currant segnent length 




bind count 

GROUP 
N A n E 



ACCOUNT 

Nunc 



entry 



■ entry 1 
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Bind Manas Data Sequent (Cent.) 



J«/,U1 »W Ta^if and pata Structyras 



I 




OJ bind count 




1 

2 
3 
4 
5 

6 
7 
10 


11 

1- GROUP 
21 

1- « « n e 

31 
4| 


51 

I- P.CC0UHT 
61 

1- hue 

7| 
81 


! a 
i v 
j a 





Data Record Foraat 



The prinary purpoee of the Serial Diec Interface (SDISC) is to adapt the 
undefined length transfers characteristic of nagnetic tape to the fixed- 
length environnent of a disc or cartridge tape (CTRPE). To acconplish this, 
data is buffered uithin SDISC. The buffer is »n integral nunber of sectors 
(blocks for the CTBPE) long, files aluays start on a sector boundary, but 
data records uithin files nay start anyuhere and straddle eector boundariee. 
A record in the buffer is structured ae follow: 



-- entry n 



I record I 
I length I 

I (bytes) I 



t record | 
I length I 
I (bytes) I 



The record length is aluays a one-uord positive byte count uhich includes 
only the data portion of the record, not the length uords thenselves. Records 
uithin a file night be stored on the disc as follow: 



I RL UllllllllllllllllllllJIIlin 
\Tlllll7lll~l\ «L I RL I//////////I 
I///////////////////I RL | Rl I//I 
I //////////////////////////////// 1 

i///i1lTru//////////////////i" 
i///////////i*rl iru//////////! 
!//////////////////////i'rlTrl"i 
I////////////////////////////////! 



I/////I RL I RL I 



I 



The reason for the trailing byte count is to inplenent an easy uay to 
backspace records. 
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End of File Fornat 



Since files always start on a sector boundary, it follows that they also 
end on one. End of files consist of a record length and 0-fill to the end 
the current sector as follows: 

I//////////////////////// RL RL /I 

MiiiiitiiiUiHiiiiiuiiHiuun 

MfUUIl RL RL /////////////////I Sector H 

| + 1 

I///////////////I RL I I 
♦ * j 

! I 

I Zero fill I 
+ +— 

In addition, an End-of-File entry is nade in the Gap Table, so that files nay 
be skipped by scanning Cap Table entries instead of serially scanning the 
data area. The Gap Table is described a feu pages fron now. 
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Cont i gu ous Block Fornat 



fl serial disc, if it can do everything a Magnetic tape can do, mist also be 
a cold-load device. This neans that nachine nicrocode nust be able to read a 
bootstrap channel progran and the resident segnents of INITIAL fron the disc 
into nenory. The nicrocode and channel prograns cannot deal with the record 
length words which surround standard data records, so for then we have a 
structure, called a CONTIGUOUS BLOCK, which has the data without the length 
words. Information as to the length of each contiguous block nust therefore 
be kept elsewhere, so there are Gap Table entries which hold the beginning 
and ending sector addresses of each contiguous block. This inplies that each 
block nust begin and end on a sector boundary. In this way they are sinilar 
to data files. To set contiguous blocks off fron nomal data, and to reach a 
sector boundary, a record length and fill character = 2177777 is used, as 
follows: 



|/////// Previous records //////| 

i /////////////////////////////// i 



I 

I////////I RL I -1 



I 



Contiguous block 



Sector N+1 

I 



Hole Fomat 



Holes on the serial disc have the sane fomat as contiguous blocks (that 
is, they start and end on sector boundaries with -1 fill characters as 
required). Starting with 11PE version G.00.00, holes are obsolete and SDISC 
will not generate then. However, code has been left in SDISC to process any 
holes found on serial discs written with earlier versions of SDISC. Further 
details nay be found in the Serial Disc IMS. 
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Gap Table Fornat 



The Gap Table is a four-word header followed by a series of two-word device 
address entries. R pemanent copy lives on the device, starting in sector 4, 
while a working copy lives in main nenory. The copy in nenory is posted to 
the disc only when a backspace or rewind operation occurs after writing (in 
other words, when the copy in twin nenory has changed). The length of the 
Gap Table is device -dependent according to the table below: 



Device 




Nunber of sectors (or CTRPE blocks) 

44 
106 

219 (250 for G.00.00 and later releases.) 
26 

4 blocks ("S" cartridge) 
15 blocks ("L" cartridge) 



The Gap Table looks like this: 



sector addr of load point |\ 
unused j \ 

unused j /-Gap Table header 

unused j / 
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Beginning of Hole. The starting address of a "defective" area of the 
disc. Usually on a track boundary, but nay be in nid-track if a con- 
tiguous block was being written when the "defect" was encountered. 
Obsolete, starting with fiPE version G.00.00. 

End of Hole. The corresponding ending address of the "defective" area. 
Always at a track boundary. Obsolete, starting with HPE version G.00.00. 
Beginning of (contiguous) 81ock. The starting address of a contiguous 
block, exclusive of the -1 fill characters which nay have been required 
to get us to a sector boundary. Unlike the End of File fill characters, 
there need not be any -1 characters if the previous record or contiguous 
block (with or without the trailing length word) ended exactly on a sec- 
tor boundary. 

End of (contiguous) Block. The address of the last sector containing 
contiguous block data. The sector nay also contain -1 fill characters to 
get us to a sector boundary, but as uith the beginning of block they are 
not required if the contiguous block ends exactly on a sector boundary. 
End of Tape nark. The sector address of the sinulated End of Tape 
reflector. This type is now written only to floppy discs for use by 
INITIAL'S serial disc interface. When read by UPE's SDISC, it will be 
skipped no natter what device it is found on. This ensures conpatibility 
uith older serial discs. 

End of Gap Table. No associated sector address. If you hit this while 
scanning the Gap Table, you've gone too far. In practice, this type is 
created whenever the Gap Table is cleared, by the sinple device of in- 
itializing the table to -1 . 



4 I type f 



I 



+ + Sector address [ Entry (two words) 



3 i 



6 I type 



I 



+ + Sector address I Entry (two words) 



7 I 



I 



The type field is bits 0, 1 and 2 of the first word, 
types are: 



The eight possible 



End of File. The associated sector address contains one or nore end. of 
file fill characters (0) to fill out that sector. In the worst case (the 
previous record ended exactly at the end of the previous sector), the end 
of file sector contains all zeros. 

End of data. The associated sector address is the last address of valid 
data plus 1, in other words, the next available address. In practice, 
such an entry is usually preceded by an end-of-file entry, since the EOD 
entry is written when you stop writing, and the file systen will not let 
you backspace or reuind after writing without sending a Urite End of 
File. An EOD entry is also written at the beginning of the Gap Table 
when new (unwritten) Media is inserted. This prevents erroneous reading 
of blank nedia. 



GOV 00 

12- 11 



G.01.00 

12- 12 



Private VoiunM/Strial Cite 



SDISC Extra Data Seontntt 



Uith insignificant txeiptioni, SDISC optrattt tntirtly In tpllt-ttMk nodi, 
that it, using in txtra mi ttgntnt for lt> working itoragt. Starting with 
HPE version G.00.00, thtrt art two additional data ngnantt used 11 no-ualt 
data sufftn. For tht noit pirt, our diieuition htrt is rtttriettd to tht 
original dita ttgntnt, nou und only for variabltt, At Gap labia, and data 
bufftr ntnagmtnt. 

Tht working itoragt antra data itgntnt (KM) it uiually acquired by tht ex- 
ternal procidura ALLOCATE uhtn tha atrial ditc dtvict it firtt anigntd to a 
uur aa part of an FOPEM. Tha txttmtl proetdurt DEALLOCATE naket tht KDS go 
auay at part of iti proetating of tht Final FCLOSE against tht dtvict. Tht 
•ytten progran PVPROC nay alto acquirt and rtltatt an KDS to that tht tapt 
label routintt in LA8SEG nay alto utt SDISC for their uork uhtn DEVREC 
processes a dtvict on-lint interrupt. SOISC allocattt tht tuo data bufftr 
wgnentt at thty art nttdtd, thtn deallocate! then at part of tht Dtvict 
Clott proetating. 

In addition to tht Cap Tablt already dttcribed, the KDS containt SOISC '1 
global itoragt area, including the data bufftr nanagtntnt artat 
(BUFfER'INFO), and a anall buffer (called UORKTAeiE). UORKTHBLE holds tht 
contents of the Serial Disc label lector uhen SDISC reads it in as part of 
its self-configuration. It also hold the Defective Tracks Table (IMC fanily 
discs) or Defective Sector Table (CSSO discs) uhile reassigning suspect or 
deleted tracks. 

The three arrays in the KDS (UORKTABLE, BUFFER'INFO and GPT (Gap Table)) 
are all dynanically configured by SDISC as vanilla indirect arrays, such aa 
night have been constructed by SPL. This is done by declaring the array 
naties as pointers, then inserting appropriately conputed eltnent-0 addresses 
in then. 

The extra data segnent is organized as follows: 



I UORDSPERSECTR I 
I t 

1 I SECTORSPERTRAK I 
I I 

2 I STARTAOORESS (B0T)| 

i I 

3 I EOTSECTR (disc 

I address of sinu- I 
lated end of tape)! 



These twelve wordt are reserved 
for use by ALLOCATE when the data 
segnent is created. However, AL- 
LOCATE only stuffs the last five 
of then. Ue fill the first seven 
ourselves uith infomation ue get 
fron the label sector. 



Private Voluntt/Jeritl Diac 



Volunt Fatal Error) If TRUE, disables SDISC until a ntu voiunt 

. ! it nounttd. 
ItfW'DSES'SIZE I lta« tin of our KDS, to ut can 
cheek that it's big trough, 



SDISC global veri-l 
abltt, includlngl 
array pointtrt. I 




Ungth it S12 words. 



Length is calculated as 
MK'NOTT BUFFERS (currently 2) * 
INFO'EMTRVSIZE (currently 8). 



Length varies uith device, and is 
calculated by SDISC as part of its 
self-configuration. 



EODSECTR (last 
sector of disc) 



I Sinulates tape runoff. 



JUSTALIOCBTEO 



WRITE RING 



Tells us to initialize SDISC 

paraneters to BOT if true. 

Simulation of tape urite ring. 



FATRLERROR | Disables SDISC pemanently when true. 
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Serial Ditc Organization 



The ditc is organized as follows: 



I Label sector 

4— _ 

I DTT/DSCT 

* _. 

I Cold load 

t 

I Soft dunp 



See expanded view in Chapter 3. 

1 OTT (DAC fanily) or DSCT (CSSO). 

2 HP-IB cold load channel prog. 

3 SOFTDUNP channel progran. 



I Gap Table 

i ; 



Last data sector 



I 4 to STARTADDRESS - 1 . 

I 
I 
-+ 
I STARTADDRESS 

to 
EOTSECTR 

to 
EODSECTR 
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CHAPTER 13 I/O 
I/O Table Linkage 



->/ LOGICAL \ I/O TABLE LINKAGE 
\ DEVICE / 



I 
I BITP 
I FLAGS 



->l FLAGS li- 



IOO* 
->| FLAGS | 

I IOQP I 
— I ILOEV I 

I I 



I DITP I 
-I IOQP* | 

I UNIT ILOEV | 
-I DLTP | 

I ILTP | 



I ILT 



I- 



->|Ch| 



I I I 
I I 



IORT I 
SIOP I 



| | | UNIT EXTRACT 
I I 



I 



I ISIOP I Q » I 
I I SIZE I I 



I I 
I I I 



I I 



I I 

I I 
I I 



I | OITP 
| | 



|i 



I for disc requests 



>|SI0 PROG AREA 
I DRT | 
I SIOP I 

I FI I 

>| ILTP | 

f I 
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Driver Linkage Table (DLT) 



1 2 3 4 5 6 ? 8 S 10 11 12 13 14 15 

|_|.-|-|-.|~|~|~|~|~|-|"l"l-l-|-|~l 

1 IDFWCICRI 10 IBTVP | 

0| QUEUE MINDER I (SEE BELOU) I 

| j 

11 MONITOR PLHBEL I 

| j 

J I INITIATOR PLBBEL I 

| 1 

3| COBPLETOR PLABEL ! 

I— 1 

4| INTERRUPT PLABEL I 

I " I 

51 DIT SIZE I DEVICE TYPE I 



CS DRIVER EDITOR PLABEL 
INITIALIZATION PLBBEL 



DPROC 
DBNTR 
DINIT 

Dconp 

DINTP 
DTYPE 



I/O 



Device Reference Table (CRT) 



HP-IB Systems 



I Bank of DRT I 

| 1 

I Offset of DRT in Bank I 



DRT ENTRY ON /33. /44 



SIOP 



PI 



Channel Hags 



There is one DLT for each type of driver, fl pointer in the DIT allous 
different devices on a controller to have different drivers and 
interrupt handlers. 

DPROC. QHUnB - This field contains the I/O process request queue 

nunber for type 2 drivers. Zero for all other types. 
.(3:1).DRVRFRZN - Driver cede frozen. Set by "fiii when then the driver 

CDF) cede segnent has been nade present and frozen fron a 

request fron SIODtl. 
.(9:1).BABERR0RC- HAfl Error on Code Bakepresent 

(HC) 
.(10:1).C0RERES - If set both initiator and conpletor code »n core 

(CR) resident. 

.(14:2).DRVRTYPE- DWVER/nONITOR TYPE 

(NTVP) - not used 

1 - driver can be executed on any stack 

2 - driver can be executed in the user process or 

in the I/O process identified by IDNUBB 

3 - run only in process whose PCB nunber is in 

IDNWB 
DBHTR - I/O Bonitor Plabel. 
DINIT - Driver Initiator Procedure Plabel. 

DCOBP - Driver Conpletor Procedure Plabel. 

DINTP - Special interrupt handler Plabel. This procedure is called 
by GIP if ISPEC is set DFLAG. No other action is taken by 
GIP except to set the Interrupt Status in DSTAT. 

DTYPE.DITSIZE - The length of the DIT in uords for this driver. 
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SIOP - absolute address of SIO progran 

PI - interrupt handler plabel 

DBI - this is the absolute address of the ILT 
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Logical- Tj-Physical Device Table (LPDT) 



DST = 13 i- 115) 
SIR = 9 (= 111) 

The LPDT has several fields which describe the state of a device. Sone of 
these fields have the sane Meaning for all devices. Others are device depen- 
dent. All are described below. 

There are tuo types of devices represented in the LPDT: real devices and vir- 
tual devices. A real device is one uhich has been configured into the systen 
and is capable of performing input and/or output. A virtual device sinulates 
sone of the properties of a real device (for exanple a spooled line printer 
or an INP), but there is no physical I/O involved. The tuo nain uses for vir- 
tual devices are for OPEN spooled devicefiles and certain connunication 
devices (such as INP's). 

A given virtual device entry is in use only uhile the devicefile it 
represents is open. Uhen the file is FCLOSEd, the entry becones available for 
another virtual device. This is the reason for the SYSDUBP/INITIAL con- 
figurator question BAX « OF OPEN SPOOLFILES— it needs to knou hou nany vir- 
tual device entries to allocate to the LPOT (and to the LOT). 
Entries in the LPOT are ordered by logical device nunber. The first uord ad- 
dress of a real device entry is obtained by Multiplying the LDN by the entry 
size. Except for the Oth entry, entries for which no logical device is con- 
figured on a given systen are used for virtual device entries. Any renaining 
virtual device entries follou the last real device entry. 
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Entry 

1 2 3 4 i t 1 I I 10 11 12 13 14 15 

0| Number of tntriet in tabic I 

♦ t 

1 1 Entry slit • 4 | 

♦ * 

2 1 OEVREC •trviee request count | 

♦ --* 

Diicuiiion: 

Uord 2 it incremented by i device driver uhenever it ttti the Device 
Ounerthip State field (belou) to 2 (Service Requested). OEVREC decrement! ttit 
count for each interrupt it acrvicw until the count nuchas 0, at uhich tint 
OEVREC hibernates. 

-- CAUTION - 

Davica drivtrt must lock this tabla by DIS- 

ABLE/ENABLEing, -NOT- by trying to acquira 

tba LPDT SIR. 

Typical Entry (Virtual Devices) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
♦-I-I-I-I-I--I-I--I--I--I-I-I--I-I--I-* 
Ol 1 1 Pointer to K00 aubentry | 



II 



I I I I I I 



I I I 



I 



21///////////////////////////////////////////////1 
vmniiiiiiiiininiitiiiiiiiniiiuiniiimm 



10 — for input, 1 for output. 

Uord 0, bit it 1 for a virtual device, for a real device. The fields in 
uord 1 art the sane, as applicable, as for the real device represented by a 
given virtual device. See belou. 
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Entry for Terminal-Like Devices 

1 2 3 4 5 6 7 I 9 10 11 12 13 14 15 

•-|-|-l-l-l-l-l-l-l-l-l-l-l-l-l-a 
OIOI////////////////////////////////////////////I 

+«+--+--+--+--♦--♦--+ *—*—* « 

IDevc I JIDalCtl D| II End of I 8| LI Device I 

1|Ouned| o|tallV| u| n| File I r| ol Subtypel 

IStatel b| I I p| tlCnditionl h| g| | 



2| 



SYSW- relative pointer to the DIT 



t ___ I 

3|/////////////////////////////////////////7////7| 
♦ 1 

Discussion (unique fields only): 
Uord 1.( 4:1) — CONTROL-* is allowed and has teen detected. 

Uord 1.(10:1) - BREW has been detected -OR- ignore BREAK if the C.I. is 
running. 

Uord 1.(11:1) — The terminal it logging on. Thit bit is set by PROGEN and 
OEVREC uhen the logon sequence starts. If the bit is off 
uhen polled by INITJSIH 1 , the teminal has disconnected. 
For run, only IOTERMO and H10TERD support the use of this 
bit. nultipoint and OS pseudo-terminals do not. 

Entry for Tape Privet 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 

♦--l-|-|~l~l~l"l~|--|--|"|~|~|--|-|-t 

oi oMiiiiiiiiiiiiiiiiiiiiiniiiiiiiiiiiiiiiiiiin 



IDevc | J|0a| B| Dl II End of 
1 lOunedl o|ta| 01 ul n| File 
IStatel b| | Tl p| tICndition 



I R|Ru: Device I 
I VI to: Subtypel 
I Rl : I 



21 SVSDB- relative pointer to the DIT I 

3t7/777T«Ri777/7/77/77//77//77/77/77/7/7//777777/T 
t , 

Discussion (unique fields only): 

Uord 1.( 4:!) ■- BOT. Tape it at Load Point -OR- no tape nounted. Recording 
density nay only be suitchtd uhen thit bit is true (for 
nultiple dansity tape drives). 



Word 1,(11:1) ■ 



If trut, OEVREC it performing Automatic Volume Recognition 
(RVR) on a tape (or PVPROC is doing the same on a serial 

ditc), -OR- RVS it to be tupprciied on job or data scctpt- 



6.01.00 
13- 7 



I/O 

Typical Entry (nil Real Devices) 

1 2 3 4 6 t 7 I 9 10 11 12 13 14 15 

.--M--I--I--I--I--I--I--I--I--M--I--I--I"* 
01 0I////////////////////////////////////////////I 

,..,..»..... 4 ~i~*~, ♦-.»-# , 

IDevc I JIDal 

1 Ouned I o|ta| 

IStatel bl I 



I Dl II End of I I IRu: Device I 
I u| n| File I I to: Subtypel 
I pi tlCnditionl ill 



2| SWDB-relative pointer to the DIT | 



Diacuttion: 
Uord 1.( 0:2) — Device Ownership State: 

— Rot ouned by any process. 

1 — Ouned by a process. 

2 — Service requested. Set by driver for 

unexpected interrupt, then uakes OEV- 
REC. 

3 — Service granted. Set by OEVREC. Logon 

sequence is 0-2-3-1 . 
3 ~ Device reserved (alternate use). Set 

during STflRTSPOOL, spooler process 

sets to 1 uhen it gets started. 
Uord 1.( 2:1) — Device is Job/Session Accepting if true. 
Uord 1.( 3:1) ~ Device is Data Accepting if true. 

Uord 1.( 5:1) — Device is Duplicative if true (all devices except discs). 
Uord 1.( 6:1) — Device is Interactive if true (all devices except discs). 
Uord 1.( 7:3) — End of File condition: 

— Ho EOF detected. 

1 -- Harduare EOF (e.g., tape nark). 

2 — :DATA record read. 

3 — :E00 record read. 

4 — :(CLL0 record read. 

5 — :8¥E record read. 

6 — :J06 record read. 

7 — :EOJ record read. 

Uord 1.(12:4) — Device subtype. See discussion for tape entry (belou) for 
a description of the Auto bit (12:1). 

The renaining bits in Uord 1 are device-dependent and are described uith 
their corresponding entry diagran. 
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Uord 1.(12:1) — Part of Device Subtype field. If true, device nay be allo- 
cated automatically uhen opened. If false, operator nuat 
allocate. 

Hard 3.(2:1) - AUTO REPLY. Device nay be allocated uithout prompting the 
operator for REPLY. This bit is set automatically if uord 
1 (12:1) is true. 



Entry for Disc Drives 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 
♦--I-I-I-I--I-I--I--I--I-I-I-I--I-I-I-* 
S\»\IIIUIIIIIIIIIIIIIIIIIIHIIIIIIIIIIIIIIIIIII\ 

4 — +--+-_+--+--+--+-. 4 4--t--4 4 

IDevc I JIDal N|Bt|RV| End of I S| F|Au: Device I 

1|0uned| o|ta| S|d I I File |or| olTo: Subtype! 

IStatel bl | D|PV| ICnditionl F| r| : | 



21 



SVSDB-relative pointer to the DIT 



I 



3I//IS0|AR|//////////////////////////////////////| 



Discussion (unique fields only): 
Uord 1.( 0:2) — Device Ownership State, "ay not be 1 (ouned) for shared 
device (systen volume or private volume). Serial and for- 
eign disce are non-tharable and nay be ouned. See the full 
discussion of thit field under Typical Entry, above. 

Uord 1.( 4:1) — If true, the disc is a nonsysten donain (private volune, 
serial disc or foreign disc) disc drive. 

Uord 1.( 5:1) — If true, disc is a mounted private volune. 

Uord 1.( 6:1) — If true, the disc is a reserved volune used to satisfy the 
requirements of a nultiple volune private volune set. 

Uord 1.(10:1) — If true, the disc is a physically and logically nounted 
serial or foreign disc. Bits 5 and 6 nutt be false. 

Uord 1.(11:1) -- If bit 10 it true, then 1 ■•> foreign ditc, «> serial 
ditc. 

Uord 3.( 1:1) — If true, the device is currently being used at a terial 
ditc (that it, it is allocated to a user as a serial 
disc). This bit duplicates a bit in the LDTK entry so that 
this information can ba found in a systen (ntnory- 
resident) table. ' 

Stord 3.(2:1) -- RUTO REPLV. Device nay be allocated uithout prompting the 
operator for REPLV. Thit Sit it eel automatically if "uord 
1 (12:1) it true. 
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Logical Device Table f LPT) 



Overview of Data Seqnent 



DST 14 (= Z16) ♦- 
SIR 10 (= Z12) 



Logical Device Table 
(LOT) 



+ 



Logical Device Table 
Extension 
(LOTXJ 



Logical Device Table 
Zero Entry Forwat 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



-|-|-l~l~l~|-|--|--l"l~l-|-l- 



Highest entry nunber 



i 



Entry size = 6 



Ol 

+ - 

11 
+- 
2{ Streatis device nunber I 

VlllllllilllllltltllllMIIIIIIIIIIHIHIUIIIIli 



miiiiimiiiiiiiiiiiiiiiiiiiiiiiiiiiiiitiiiiiin 
suiiitiiiiittiiiiiiiiiiiitiiiiHiiiiiiiiiiiiiim 



s\iimiiiiiiiiiimiiiiiiiiiiimiti!iiiiiiiiiii\ 
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Typical Entry Fomat 

1 2 3 4 S 6 7 I 9 10 11 12 13 14 15 
♦-I-I-I-I-I-I-I-I--I-I--I--I-I--I--I--* 



File use count 



I Volune table index if device type = 0-7, else I 
I nain process pin # or spooler process pin tt |1 



|CS|F0| Device type 1 2 



|Spool|Sy|Di|Dn|Tr|Hd|Cl|S I Device-dependent I 
istatelstlaglRqllrlr jasl 0| info (see belou) 13 



Milium 



I 



XDD head index 
CONTROL-V pin 



I Default output device -OR- default class index 1 6 
I (see discussion) ! 

+ 1 



Uord 2. (8: 
Uord 2. (9: 
Uord 3-(0: 



Uord 3.(2:1) 
Uord 3. (3; " 
Uord 3. (4; 
Uord 3. (5; 
Uord 3. (6: 



Uord 3.(7:1) 



Uord 3.(8:1) 
Uord 3.(9:7) 



Uord 3. 
Uord 3. 



- Connunication systen device if set. 

- If set, there are special foms nounted on the device. 

- Spooled state of the device: 

-- Not spooled. 

1 — Ouned by an input spooler. 

2 -- Ouned by an output spooler. 

- Device is available to systen (not doun). 
1) — Device is available to diagnostics (obs). 
1) — :D0UN requested, honored phen use count = 0. 
1) — If set, trailers are disabled. 
1) — If set, headers an disabled. These two bits are 

nanaged such that header/trailers are generated in 

pairs or not at all. 

If I/O, uord 6 is the Device Class Table 

index/LDEW of the default output class/device 

associated with this device. 

Spooling has been enabled (spool queues are 

open) for this device. 

Device dependent infornation: 

1. For teminal-like devices, the default 
terainal type to be used if not speci- 
fied in the : HELLO connand. 

2. For variable density tape drives: 
(10:3) — actual tape density. 

(13:3) — density requested in FOPEM for writes to 
unlabelled tapes only. 
For either: 

= unknown density/no FOPEN u/ urite. 

1 = 1600 BPI 

2 = 6250 BPI 

3 = 800 8PI 

G.01.00 
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Logical Device Table Extension (LDTX) 



Overvieu of Data Segnent 

DST 14 (= 116) ♦ ♦< DST Z16 

SIR 10 (= Z12) | | 

I Logical Device Table j 

I I 

I (LOT) I 

I I 

+ + 

I I 

I Logical Device Table E 

! Extension j 

I (LDTX) | 

I I 



I /0 



Zero Entry 



1 2 3 4 5 6 7 3 3 10 11 12 13 14 15 

♦-|-|-|-|-|-|-|-|-|-|-|-|-|-|-|-t 

! Highest entry nunber I 



1 



Entry size = 5 



I 



2 I lllllllllllllllllltllllllilltlllllllllllltlllll I 

3 I /////////////////////////////////////////////// 1 

4 I///////////////////////////////////////////////! 



Typical entry 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+ __ 1H _-|„|__ MH --|-_|-|--|--|--M--|" 

j Sj3D|CP|F5|0S| Reserved | Device-specific 
+ — + — + — + — + — + * 

1 | infornation 



fields. 

See the follouing exanples 

of LDTX entries. 



2 I 

+- 

3 I 

+ - 

4 ! 

+- 

Uhere: 



S Seek ahead enable/disable flag (systen or PV disc only). 

SD This logical device is a Serial Disc or a Foreign Disc. 

CP This logical device uses the CIPER protocol. 

FS This is a systen or PV disc uith Disc Free Space nanagenent. 

DS....This LDEV is a DS or data connunications device. 
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Teminal intra 

. 1 2 1 4 5 C 7 1 9 10 11 12 13 14 16 



* — I — I — 



■I-I--I- 



I 01 Oi 0! 0! Ol Reserved 



1 I 



•l"|"l"l--l»l"l- 



TBRC 



Ttminal Descriptor Table Offset 



2 I 



CHflNNEl ID 



3 1 /////////////////////////////////////////////// i 



4 1 iimmiiiiiiiiiiimmimimmtiimiim i 



TBRC.Tarainal'e baud rate codt (CPS ■ characters par second). 
Spied (CPS) PJDCC/BTP (HPIB) TBRC 



Not knctm 





1920 
960 

480 


16 (ATP only) 
8 
9 


240 


7 


120 


11 


60 


6 


30 


13 


15 


14 


14 


... 


10 


15 



US. ...This teminal is connected to a Uorkstation Configurator port. 

TDT of foot... Off set fron the base of the Teminal Descriptor 
Table (TDT) to the TDT entry for this teminal. fl 
-1 indicates no TDT entry exists for this temi- 
nal. 
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Siriil or Foralen Disc intrv 

1 2 3 4 6 ( 7 I 9 10 11 12 13 14 16 

I 01 1 1 01 01 Oi Reserved I/////////////////I 
+--+"+—♦"♦—"————+"—————+ 

1 I SOISC: KDStt for variables, Dap Table I 
I FDISC: 1 I 
i-. ....................................... ......* 

2 I SDISC: 1 ■■> data buffer KOS's acquired I 
I FDISC: not uted. | 

t...............................................* 

3 i SDISC: PC6 index uhen URITing. elia I 
I FDISC: not used, | 

*7i7ti7777777777777t77itiiit7t7i777titt7t7ti77777\ 
4... — .................................. — + 

"PER Entry 

1 2 3 4 5 6 7 t 9 10 11 12 13 14 16 

♦"I--I--I--I--I--I--I--I--I--I--I--I--I--I--I--* 

I Oi 01 11 01 01 Reserved |08|/////////////////| 

4— 4 — >--4--4 4--+ 4 

1 I CIPER Device Control Data Segnent « (COCDS) I 
4—4 , 

2 I ON I CTK Index for this device (CTnT) I 

3 X7i777777777777777777777777i7777777ii7t7777777i7\ 

4 1 /////////////////////////////////////////////// I 
+ + 

DB If set to 1, then debugging is in effect. 

ON If 1, the CIPER facility has been de-activated for this 

device because of error. 
CTHI... Control Table flap Index (an index into the Control 

Table Dap (CTH), uhich is located in the COCDS. 

Systen or Private Volune Disc Entry 

1 2 3 4 S 6 7 E 9 10 11 12 13 14 15 
♦ — ■ — I — I — I — I — I — t — I — I — i — i — I — I — I — I — * 

I S| 01 01 1|0| Reserved 1 11111111111111111 1 

1 *\mi77777777777777777777777ii77777777777777777i\ 
4 ....... — ..... + 

2 I Disc Free Spaca DST nunber (DFSDST) | 

4................................. .... + 

3 I Disc Fret Space error status (DFSERR) I 

*X7i777it777777777777iii777)77iiii7)7it)t77i777ii\ 
*....................„................... — ^ 

S Seek ahead enable/disable flag. 
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Device Class Table iDCTI 

friryitr' a! Pm issmi 

DST 40 (■ t») t «< OST (50 

SIR 40 (■ (60) 

Device Clats Table 

(OCT) 



I/O 



Device Class Tabis Typical Entry Famat 



1 2 3 4 6 6 7 I 9 10 11 12 13 14 15 
t~|-l-l-l-l-l-l~l-l-l-l-l-l-|-l-* 



Class nana (ASCII) 



Teminal Descriptor Table 

(TDT) 



Header Entry Fomat 

1 2 3 4 5 6 7 i 9 10 11 12 13 14 15 

*-|-|-|-|--|-|-|-|-|-|-|-|-|-|-|-« 

OI Total table (segnent) size I 

4 4 

11 Entry size (variable, this uord set to 1) I 

+ . + 

2| Nunber of device class entries I 

4 . 4 

3I Pointer to first device class entry i 
I (segnent relative) 

4 .....4 

4| Nunber of teminal descriptor entries I 

4 , 

5I Pointer to first teminal descriptor entry | 
I (segnent relative) j 



4I//I 


Cyclical pointer ISQI TIClaes Potass Typel 


61 


Nunber of devices in class (N) I 


El 


LDEV «1 | 


7| 


LDEV 112 | 






NtS| 


LDEVd N | 
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Discus sion: 



The Dtvict Cl»i Tabic (DCT) contains * varying nunber of variable length 
entries. Thii is because you nay configure an arbitrary nunber of device 
classes on a systen, and each device class nay be conprised of an arbitrary 
nunber of logical devices. There is one OCT entry per device class, and each 
DCT entry contains a list of logical devices in the class. There is no es- 
tablished order of entries in the OCT, nor is there an order of LDEV* within 
an entry. 

Due to the haphazard nature of the DCT, its overall properties are kept in 
the header entry. These include the segnent -relative starting address of the 
DCT (in case the header entry should be expanded later) and the nunber of 
entries in the table. H segnent -relative pointer to the Teminal Descriptor 
Table (uhich follows the DCT) n»y also be used to calculate the size of the 
DCT. Rlso note the "Entry size" uord. It is neaningless for this table, but 
is included for conpatibility uith other fixed-length entry r)PE tables. 
Since the OCT entries $n of variable length, Hhen you uant a particular 
entry you nust aluays start at the beginning of the DCT and link through each 
entry until you find the one you're interested in. 

A feu of the fields in the DCT require further description: 

•i<T! 5,( '■;?) ---C/eikil point*-*- . Current!/ used only for system and private 
volune disc devices. The pointer varies fron 1 to K [nunber 

0.01.00 
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of entries in the class) and indicates the LDEV# in the class 
list on uhich the last extent Has allocated. The disc space 
allocation routines will try to satisfy the next request on 
the next disc drive indicated by the cyclical pointer (uith 
uraparound to 1 if the pointer > K}. If that fails, the 
pointer is increnented until space is found or all devices in 
the class have been tried, 

Uord 4.( 8:1) —If set, spooling has been enabled (spool queues opened) for 
this device class. 



Uord 4.( 9:1) —If set, the class is a teminal type class. 

Uord 4.(10:6) —Usually the sane as the device type represented by the class 
(0-7 for disc, 24 for tape, 32 for printer, etc.). Serial 
disc classes are disc devices accessed as tape drives, so 
their true device types are kept in the LOT, uhile this field 
holds a special type (31, or X37), indicating a serial I/O 
(non-concurrent) device. Sinilarly, a foreign disc is a 
nonsharable disc drive, so that fact is reflected by a spe- 
cial type 7 in this field, even though the true harduare type 
is kept in the IDT, as for serial discs. 
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Teminal Descriptor Table Typical Entry foraat 



1 2 3 4 5 6 7 S 9 10 11 12 13 14 15 

t ._|_-|„|-_|_-|--|„|„|--l~l~l--l~l~l-l--» 
0| 

! 
11 

I Descriptor file nane (ASCII) 

21 

I 
31 



Group nane 



10! 

I 

111 



12) Nunber of devices in using file (N) 



131 LDEV »1 



141 



N+121 



The Teminal -Descriptor Table contains a varying nunber of variable length 
entries, because each Teminal Descriptor entry n»y have an arbitrary nunber 
of logical devices. Houever, you can only configure a fixed nunber of valid 
teminal entry files. These are the TTnn or TTPCLnn files uhich reside in 
PU8.SYS. 
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Interrupt Linkage Table (ILT) for HP-IB Svstei 



1 2 3 4 S 6 7 8 3 10 11 12 13 14 15 



7 

Z10 

111 



Z15 



Channel Progran Variable Area 
(ICFVB) For terminals uith P.TP 
drivers, this area is zero. 



Dflfl Rbort 
Address 



ni 



CHRNQUE 



I 



I 



DEV 



SYSDB relative pointer to channel progran area. I 



SYSDB relative pointer to status return area. I 



single instruction that is executed to extract 
the device unit nunber fron the status pointed 
to by ISTRP. 



ICFVBO (0 forflTP) 
ICPVS01 (0 forflTP) 
ICPVB02 (0 for DTP) 
ICPVH03 (0 for DTP) 

ICPVK04 

icpvnos 

ISRQL/ICPGfl 

ICHTRL 

ISIOP 

ISTAP 

IUNIT 



SYSDB relative DIT pointer of the device I 

currently using the channel to perfom a data j 
operation. I 



CQuEK 



KUIUP|IG|SCISQI 



X16 | SYSDB relative DIT pointer for unit 



I HCUNIT | 



J.MIJCUC 

IFLflG 

IDITPO 





I SYSDB relative DIT pointer for unit n 


I 


! Progran status return area 
I pointed to by ISTBP 


I 
I 


I Seeknssk (Disc only) 


I 


I I/O 

| Progran 

\ Area 


I 
I 
I 



I/O 



ILT (Cont.) 

IPCVR - These four words conprise the channel progran 

variable area uhere info mat ion is stored concerning 
a channel progran Interrupt instruction or abort. 
CPVRO should be used only For channel progran aborts. 
ICPVfW - Uords 4 and 5 contain DRR address, when channel progran 

aborts during Dflfl transfer. 
ISRQL - Serial poll request queue length. HP-IB Systens do 
not support any serial poll devices. This should 
aliiays be zero. 
ICPGtl - This is the SVSDB relative address of the channel progran 
to be started for this device after receiving a HIOP 
interrupt in GIP. GIP will call STflRTIO uhen the flags 
word indicates "ignore halt interrupt" and "start channel 
progran" bits are set. 
ICHTRL - Contains controller infomation. 

.n If set, the controller is sharing a software channel 
resource in order to Unit banduidth. 
.CHNQ The software channel resource nunber. 
.DRTN The DRT nunber for a Series 33 device is equivalent to: 
.CHAN - channel nunber (4 nost significant bits of DRTN) 
.DEV - device nunber (3 least significant bits of DRTN) 
IFLflG - Used for controller flags. 

,RU Runuait flag, fin idle channel progran should be started 

uhen there are no active requests to process. 
.UP Haitprog flag, An idle channel progran has been started 
for this controller. This bit is reset by an interrupt. 
.IG Ignorehi flag, fin HIOP instruction has been issued against 
this controller, but the channel progran u*s net in a 
wait statenent. Therefore, ignore the interrupt generated 
by the channel code uhen this progran halts. 
.SC Start channel progran flag. Uhen set along uith the IG 
flag, GIP uill start a previously attenpted SIOP on this 
device. 
.38 Start channel progran "queued" flag. Uhen bit SC is set, 
this bit will deternine if the call to STflRT'HPIB uill 
have logical parameter QUEUED true or false. 
.HCUNIT Highest configured unit nunber for this controller. 
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Than ia ont 01T ptr physical dtvict. If a physical dtvict reprtaentt 
rtprtttnts nom than ont logical devict, th< logical device nunber ia ob- 
tained fran thi I/D quaut tltntnt. Although details of DIT'a vary with 
device, tht following ttructurt ia eonnon to all: 

PIT for HP-IB Systems 



1 2 3 4 5 B 7 J 9 10 1112 13 14 1S 

4».4..4..4..4..4..4-»4.»4*.4*.4-.t.- ♦•«+••♦«♦-»♦ 

|T |D |nf IRQISIIMUI OIIO|IA|NO|ST|KS| STATE I 
+--♦— ♦"#—♦"+'"■♦"+"+"+--♦"+--+— +"+"+«+ 

1 ISVSDB rtlativt pointer to tho DIT for tht namt I 

1 daviea rtquteting thia rtaouret or atrvict I 
4 — - — .......... ........ — .-+ 

2 ISVSDB rtlativt pointar to tht firtt IDS in I 
I raquttt litt for thia dtvict I 



3 I 



Logical dtvict nunbtr 



I 



4 ISVSDB rtlativt pointar to Daviea Linkage Tablt I 

4 4 

5 ISVSDB rtlativt pntr to Inttrrupt Linkage Tablt I 

4 4 

6 I Controller Harduart Status I 



7 IHardwart error status. Set when the driver I 
I detects eh error. Uhenever oO, the driver I 
I nonitor logs an 1/0 error and clears this uordj 



S I 
9 I 



Device Dependent Area 
Device Dependent Area 



101 I0T I/////////////////I Phya. unit * 



OF LAS 

DUNK 

DXOV 

DLDEV 
DOLTP 
DILTP 
DSTfiT 
DSERR 

(DIME) 
(OTAQX) 
DUNIT 



OTRQX Used by aont dtvict drivers, it denotes tinar 
request index. 
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Pit Terminology for HP-IB Svatana 



DFLM - DEVICE RELATIVE FLAGS 



T 

AC 

rq 

NU 
10 
IA 
HO 
ST 

SI 
HS 



SET IF DEVICE IS A TEAMINAL. 
SET IF DEVICE IS A DISC. 

ACTIVE BIT. 1 IMPLIES A nOKITOR CURRENTLV SERVICIHO 
THIS DEVICE. 

REQUEST BIT. 1 IMPLIES SERVICE REQUESTED UHILE 
MONITOR IS ACTIVE. 
IF SET, MULTIPLE UNIT CONTROLLER. 
IF SET, THEN A CHANNEL PROGRAM IS CURRENTLV EXECUTING. 
IF SET, AN INTERRUPT OR RESPONSE HAS OCCURRED. 
IF SET, DEVICE IS IN A HOT REAOV OR OPERATOR IBM. 
IF SET, AN IDLE CHANNEL PROGRAM SHOULD BE STARTED FOR 
THIS DEVICE. 

SPECIAL INTERRUPT HANDLER 
DO NOT SHORT I4AIT THIS DISC 
STATE CURRENT DRIVER STATE AS DEFINED BV THE MONITOR. 
ALLOWABLE STATES ARE; 

- JTART REQUEST 

1 -TOT USED (BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COHPLETOR 

4 - HOT USED (BUT RESERVED) 

5 - COMPLETE REQUEST 

6 - UNEXPECTED INTERRUPT OCCURRED 

7 - START OPERATOR INTERVENTION UAIT 
110 - UAITINO (ON OPERATOR). RESTART AT 
Z11 - UAITINO (DATA nfiKEPRESENT/FREEZIHG) 

Z12 - UAITING (INITIATOR CODE MBKEPRESENT/FREEZE) 

113 - UAITINO (FOR COMPLETION INTERRUPT) 

Z14 - UAITINO (FOR DEVICE CONTROLLER AVAILABILITY) 

115 - NOT USED (BUT RESERVED) 

116 - UAITING (INITIATOR CODE nRKEPRESENT) 

117 - UAITING (COMPLETOR CODE MBKEPRESENT) 
KIT - I/O Systen type O-Series Will I/O Systen 

1 -HP-IB Systent 

2-unused 

3-unuaed 



Device Information Tablt (DIT) for CIPER 



Thane is ona DIT per physical device. If a physical device represents nort 
than ont logical dtvict, tht logical device number ia obtained fron the IOQ 
tltntnt (houtvtr, thia driver only supports ont dtvict par eontrolltr. ) Tht 
follouing diagren shout tht OIT used for tht HP-IB CIPER physical drivtr, 
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1 2 3 4 5 6 7 t 9 10 11 12 13 14 15 MHEI10HIC 
+"+—+--+--+"+"+"+"+-.+--♦"+--+ — ........+ 

0| 0| 0|AC|RQ| 0| 0| 0|IO|IA|HO|3T| 0| STATE I DFLAG 
+--♦—+..+.-♦-.♦-.+"+"+--♦--♦-.♦--+.—-——♦ 

II SYSDB rtlativt pointtr to tht DIT for tht next I DUNK 
I dtvict requeuing thia rtaource or tarvica I 

4................................«..».».......4 

21 IOQ tablt indtx to the first 100 in I OlOfiP 

I rtquttt litt for thia davict I 

«...»4.................4........».............4 

31 I0T I Phya. unit * I Logical dtvict nunbar I DLDEV 

4.....*.................*.......................+ 

4| SYSDB rtlativt pointtr to Dtvict linkage Tahiti DDLTP 

4 4 

51 SVSDB rtlativt pointtr to Intrp Linkage Table I DILTP 

4--+—+ — 4— 4--4-— « — 4 — --..—.—.4 

6|VS|BB|RE|TP|HR| NR CHT | DEVICE STATUS I DSAVE 

4~4--4~4--4--4 4 4 

7| Harduart error atatus. Set uhen the driver I DSERR 
I detects an error. Uhenever oO, the driver I 
I nonitor logs an I/O error and clears this uordj 

4 4 

Z10| Bit is set at conpletion of titter I DTIHE 

4 4 

Z11| Holds the tine out request entry index uhile I DRQST 
I a tintr ia activt. I 

4—4—4—4—4 4 4 4 4 

Z1 2 1 RF |UE | DEI TO I UNIT CNT|OATA CNT| TO CNT |PRTV CNT| DCOUNTS 

4—4—4—4—4 4 4 4 4 

Z13I Error logging location A1 I DLOGERROR 

4 4 

Z14| Error logging location HZ I OLOGCOUNT 

4 4 

DFLAG - Flags and request statt 
AC RCTIVE - A nonitor ia currently ttrvicing this dtvict. 
RQ REQUEST - A service rtqutst is pending uhile the nonitor ia 

active. 
10 I0PR0O - An I/O Channel Progran ia running for this device. 
IA IRK - An interrupt or response has occurred for this device. 
NO NOTRDV - Go to state Z10 after Idle Channel Progran is started. 
ST STUAIT - The device nonitor is starting an Idle Channel Progran 

for thia device. There ia no IOQ associated uith this 

type of rtqutst. 
STATE - State of tht dtvict nonitor. Specifies the next action 

to be taken in SIODM in aervicing the rtqutst: 

- ttart ntu rtquttt 

1 - not used 

2 - call drivtr initiator procedure 

3 - call drivtr conplttor procadurt 

4 - not ustd 

5 - process rtquttt completed 

6 - initiate device recognition sequtnee 

7 - start operator inttrvention uait 

G.01 .00 
13- 23 



Z10 ■ 



uait for inttrrupt (optrator inttrvtntion) 

rattan at ttttt 
111 - uait for data atgmtnt fruit, thin ttata 2 
X12 - uait for drivtr initiator to be frozen, than 

allocate controller (state 2) 
X13 - uait for I/O conpletion inttrrupt, thtn atatt 3 
Z14 - uait for eontrolltr, thtn call drivtr initiator 
Z1S - not used 

Z16 - uait for initiator ntkt prtttnt, thtn atatt 2 
Z17 - uait for cottpletor ntkt prtttnt. thtn atatt 3 

DLDEV - I/O aytttn typt, unit and logical dtvict nunbar 

- HP3000 Stritt ill/Ill 

1 - HP 3000 HP-I! 

2 - Unuted 

3 - Unuted 

DSAVE - Device processing flaga 

VS - VALID STATUS - Set to indicate Device Status has been updated. 

AB - OVRABFLAG - Sequence Abort in progress due to ABORT request. 

RE - RETRVFLAG - Sequence Abort in progress due to »n error. 

TP - TIMERPOPPED - Current error is due to softuare tiner popping. 

NR - NOTROYFLAG - Not Ready Uait in progress. 

NR CNT - Nunber of Not Ready Uaite during this requeet. 

DEVICE STATUS - Device statue returned during a Sequence Abort. 

BIT 8 - CRC available and tnabltd. 

"9 - Reserved. 

" 10 - Reserved. 

"11 - Reserved. 

"12 • Pouer fail or reset has occurred. 

"13 - A protocol error has been detected. 

"14 - A parity error has been detected. 

" 15 - The peripheral haa data to send. 

DSEAR - Pointer to statue to be logged. 

Bits(0:8) - Nunber of uords to be logged. 
Bits(3:8) - Offset relative to DITP(O). 



DCOUNTS 

RF - REQ FAILED 
UE - UNIT ERROR 
DE - DATA ERROR 
TO - TIME OUT 
UNIT CNT 
DATR CNT 
TO CNT 
PATV CNT 



- Error flags and error counts (4). 

- An error has forced this request to be aborted. 

- The current error is a Unit Error. 

- The current error is a Data Error. 

- The current error is a GIC Tine Out Error. 

- Nunber of Unit Errors during this request. 

- Nunber of Data Errors during this request. 

- Nunber of GIC Tine Outs during this request. 

- Nunber of HP-IB Parity Errors during this request. 
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PIT for Channel Devices 

1 2 3 4 5 



9 10 11 12 13 14 15 



TERn|DISC|HCT|REQI I H I SID I 10 IIAK| n |NT| I STATE DFLAG 
| | | I | UNIT | PREtlPIPROGI |HEA0|RY| I 



LOGICAL DEVICE NUMBER 



Controller Hardware Status 



Hardware Error Status 



IOT | 



DRIVER DEPENDENT DIT AREA 



DI08P 

DLDEV 

DLTP 

DILTP 

DSTAT 

DSERR 

DTII1E 

OTRQK 

OUNIT 



DFLAG. TERMINAL - Device is a terninal 

.DISC * Device is a Disc (Git 0=0) 

.ACTIVE - A nonitor is currently servicing this device 

.REQUEST - Service requested uhile nonitor was active 

.M1IHIT - device controller servicing nultiple units 

.SIOPREWT- If set then a request has been queued for 

this device. Preenpt code is set in IOQ. 
.I0PR0G - I/O progran in progress. Oeerenent SIOCOUHT and 

check for nulti-channel when conplete 
.IRK - Interrupt or Response has occurred, 

.n HEAD -Moving head disc 

.NT RDV -Not ready for SIO. SI0N1 holds off next SIO until 
ALLOUPOLL is done. 

DTRQX - Used by sone device drivers, it denotes tiner 

request index. 
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DIT For 7905/7906/7920/7925 

12 3 4 5 6 7 



I--I--I— | — I — |- 



-I--I- 



S 9 10 11 12 
-I — I— I--I-I- 



0| 0| 1|ACT|REQI C0| H | 0| I/OIIHK) 1 I 01 0| STATE |0 
| | | I I | UNIT I IPROCI I I I I i 



NEXT DITP 
CURRENT (ACTIVE) DISC REQUEST 



LOGICAL DEVICE NUnBER 
DLTP 



I 1 
-I 

12 
-I 

I 3 

4 
5 



-1 UHEH POUER FRIL 



1 

7| « OF ERROR UOROS TO LOG I DIT REL ADDR TO LOG 17 
| 1 

HO 



INDEX OF FIRST REQUEST IN QUEUE 



INDEX OF LAST REQUEST IN QUEUE 



111 
| 1 

101 IOT I/////////////////////////I PHYSICAL UNIT » |12 

| 1 

11| SIO PROGRAn-RELATIVE ABORT ADDRESS 113 

i- — ! 

lZj CURRENT PHYSICAL 1 14 

13 1 DISK ADDRESS 1 15 

116 

-I 
117 

--I 
1 20 

--! 
121 



I- 
141 



151 

I- 
161 



CURRENT DATA BUFFER ADDRESS 
UORD COUNT REMAINING 



171 



CURRENT UORD COUNT 
SYS6UF INDEX 



STATUS 1 RETURN 



191 

I- 
20| 

I- 
211 



STATUS 2 RETURN 



STRTUS 1 RETURN 



23 1 



1 24 
-I 

1 25 
-I \ 

I I 
-I I 

I I 
-I I 



DFLBG 

DUNK 

DIOQP 

DLDEV 

DDLTP 

DILTP 

DRQST 

DSERR 

0MBI1Q 

DM1QT 

DUNIT 

DLOGSIOP 

CFOfi 

CDBA 
UCR 

cue 

SVSBUFA 
STAT1 
STAT2 
CEDA 
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DIT for Channel Devices (Cont.) 



DF LAG. STATE 



DLINK 
DIOQP 
DLDEV. 



DDLTP 
DILTP 
DSTAT 

DSERR 



LOEVK 
UNIT 
IOT 



- this quantity specifies the next action to be taken 
in servicing the request. 

O-neu - start request. 

1-not used. 

2-call Driver Initiator Procedure 

3-call Driver Conpletor Procedure 

5-conplete request 

6-device recognition 

7-start operator intervention uait (210) 
110-restart request on interrupt 
111-uait for data to be frozen then state 2 
Z12-wait for driver code to be frozen then state 2 
213-call conpletor on interrupt 
214-nait for device controller 
215-not used 

X16-wait for initiator nake present then state 2 
X17-wait for conpletor nake present then state 3 

- SYSDB relative pointer to the DIT for the next device 
requesting this resource or service. 

- SYSDB relative pointer to the first IOQ in the request 
list for this device 

- Logical Device Nunber 

- unit nunber of the physical device. 

- 10 type 0=> Series III I/O, 1=> HPIB I/O 

- SYSDB relative pointer to the DLT. 

- SYSDB relative pointer to the ILT. 

- interrupt status For this device. Set each tine the 
device interrupts. 

- Harduare Device Controller Status. Set uhen the driver 
detects an error. Uhenever not zero, SIODB logs an 
I/O error and clears this word. 

- tine out conpleted flags. If a tineout occurs in response 
to a titter request type Z20 (I/O request), the sign bit 

is set in this uord. The IA bit in DFLAG is also set, 
and the nonitor for this device is awakened. (Only used 
if tiner services are requested, dust be word #8 if tiner 
services are requested. ) 
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DIT for 7905/7906/7920/7925 (Cont.) 



24 i 

I 
251 

I 
261 

I 
271 

I 
2SI 

I 
291 

I- 
301 

I 
311 

I- 
321 

I- 
33| 
341 

I- 
351 





HEAD 


! SECTOR 


DISPLACEIIENT 






PATT 1 






PATT 2 


PATT 3 




SECTOR COUNT TO TRANSFER 



REQUEST 
SYNDROME 

I 

I 

I 

I 

I 

I 

/ 



INITIALIZE ADDRESS 



1 36 INITADR 



1 37 
-I 



I L|40 DNISC 



CNTLR STRTUS AFTER SEEK 
IN CHANNEL PROGRAM 



| 



CPVA UORD UPON CHANNEL ABORT 
CURRENT LOGICAL SECTOR ADDRESS 



1 



-I 

141 SEEKSTRT 
142 



43 DLOGERROR 

44 CLDA 



DMISC 

(15:1) L'STBT'ERR - 1 Last transfer ended in error. 



IOT - I/O Devices 

- non-HP-IB 

1 - HP-IB Systens 

2 - unused 

3 - unused 
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trror and Retry Information 

1 2 3 4 S 6 7 8 S 10 11 12 13 14 15 
|-.j~|~|-.|--|--|--|--|--|--|--l--|--t--|--|--| 
I 0| S| El n| U| T| Ol CICLI Olretry cnt QNISC OF 100 
I--I-I--I--I-I-I--I-I--I 1-—.— | 

D - retry determination 

S - request syndrome 

£ - request trror information 

(1 - update track nap 

U - writing track nap 

C - issued a recalibration 

CL- driver issuing channel dear 

T - timeout wait 

HDTE: Integrated Cartridge Tape's OIT has the sane format. 
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♦—♦—+—+—+ 



H4|R£|DC|0R|EN| 



Z3S| 



T1 



IUXRL SUITE | RPSUORD1 
-+ * 

T2 | RPSUORD2 



DFLRG - Flags and request state 

Til TER". - Set if device is a teminal. 

OS DISC - If Til - and this bit is set then the device is 

a disc, otherwise device dependent. 
RC ACTIVE - R itonitor is currently servicing thie device. 
RQ REQUEST - R service request is pending while the nonitor is 

active. 
10 IOPRDG - Rn I/O Channel Program is running for this device. 
IR IRK - Rn interrupt or response has occurred for this device. 
NO NOTRDV - Co to state 110 after Idle Channel Progran is started. 
ST STURIT - The device nonitor is starting an Idle Channel Progran 

for this device. There is no 100 associated with this 

type of request. 
STRTE - State of the device nonitor. Specifies the next action 

to be taken in SIOOH in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

Z10 - wait for interrupt (operator intervention) 

restart at state 
Z11 - wait for data segment freeze, then state 2 
X12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
X13 - wait for I/O conpletion interrupt, then state 3 
X14 - wait for controller, then call driver initiator 
XI 5 - not used 

X16 - wait for initiator nake present, then etate 2 
XI 7 - wait for conpletor nake present, then state 3 

DUNK - R SVSOB relative pointer to the next OIT requesting this 
resource or service. 

DCURREQP - P current request sysbase index. 

DWiIT.(0:2) - I/O systen type 

- non-HP-16 

1 - HP3000 HP-IB System 

2 - Unused 
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CS SO Disc Dsvice Informatio n Table (PIT) 

There is one OIT per physical device. If a physical device represents nora 
than one logical device, the logical device number is obtained from the 100 
element. For the CS'SO disc controller, there will only be one device. The 
following diagram shows the OIT used by the CS'SO disc driver. 

1 2 3 4 5 6 7 S S 10 11 12 13 14 15 IWEnONIC 

OITNIDSIRCIROICOI 0| O|IO|Ill|N0|ST| 0| " STRTE ~| DFLRG 

11 SVSOB relative pointer to the OIT for the nextl DUNK 
I device requesting this resource or service I 
( , 

21 Current request index I DCURREOP 

t 1 

31 Logical device nunber | DLDEV 

t , 

4| SVSD8 relative pointer to Device Linkage Table! ODLTP 
* 1 

5! SVSOB relative pointer to Intrp Linkage Table I DILTP 
♦ t 

61 OSTRT is -1 when a system pouerfail occurred I OSTRT 
t ♦ 

7| Hardware error status. Set when the driver I DSERR 
I detects an error. Uhcnever <>0, the driver I 
I monitor logs an I/O error and clears this uordj 
t » 

I10| index of first request in queue I DQHEftO * 

♦ . 1 

Z11I index of last request in queue I OOTRIL * 

♦ ♦ 4 , 

1121 I0T | Physical Unit 8 | CWNIT 

I— t— ♦ 1 > ♦ 

1131 Table relative index to systen buffer element IDSBUFRDOR 

♦ ♦ 

X14| High order logical sector address of bad blk I DBROBLK1 

♦ 1 

X15| Lou order logical sector address of bad blk I DBBDBLK2 
t 1 

X16I Byte transfer left when bad block occurred I DBWKFER 
♦ , 

X17| Hardware logged error status - CfVR (0) I 0L0OERR0R 

♦— ♦ 

X20| Channel progran aborted relative offset I OSIOPSTOP 

t— ♦ 

X21 I Disc status (20 bytes)-Logged on status error I DSTRTUS 

t 1 

• I ■ I 

♦ , 

■ I • _ I 

x33|u<iiF|noi """ ?"s(»stbte"I duisc 
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DLDEV - Logical device number of this device. 

DSTRT - Set to a -1 when a systen pouerfail has occurred. 

DSERR - Pointer to status to be logged. 

Bits(0:7) - Nunber of words to be logged. 
Bits(S:15) - Offset relative to OITP(O). 

DUISC - Device dependent processing flags 

LOCK'FLO - Lock flag denoting unload status of the disc vclune. 

- Allow operator unload to the volume. 

1 - Deny operator unload to the volune. 

IGNORE'INT'FLG - Ignore unexpected interrupt flag. 
SU6STRTE • Indicates state of the idle channel progran: 

- Normal idle channel progran uait 

1 - Idle request being serviced wait 

DSBUFflOOR - SYS06 relative pointer to the systen buffer element 
used to read the OSCT. Zero, if no element gotten. 

DBBDBLK1 - High order logical sector address of the bad block 
for the Defective Sector Table (OSCT) entry. 

DBRDBLK2 - Lou order logical sector address of the bad block for 
the DSCT entry. 

DBAOXFER - Byte transfer left when bad block occurred. 

OLOGERROR - CPVfl(O) logged on hardware error status. 

OSIOPSTOP - Stopped channel progran relative offset location due 
to an error in CPVR(0). 

DSTRTUS - 20 bytes disc etatus logged on status error. 
(See CS'SO Disc Drive Status). 

RPSU0RD1 - Flags and local state 

RE - Read revision code done. 

Set if read revision code level it done. 
DC - RPS revision code. 

Set if controller is "PEP"ed. 
DR - RPS desirable. 

Set if RPS is desirable. 
EN - RPS enabled. 

Set if default value far RPS is enabled. 
H* - M*«r is processing a narginal data error 

0.01.00 
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fron the drive. Do not return hard error. 
Local State - State of the local request nade by driver 

- No local request is being processed 

1 - Reading rev code 

2 - Setting default RPS 

RPSU0RD2 - Default value for RPS 

T1 - Tine to target in hundreds of Microseconds 
T2 - Uindow size in hundreds of nicroseconds 
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PIT for 7970 Magnetic Tape 



1 2 3 4 5 6 7 8 9 10 11 12 15 
|..|_.| — |._|-..| 1_| 1 — |_-.|_-| H 1 

I o| oiactireqi o i n l o| i/oiiaki o i oi oi state i 

I I I I I IUNIT I IPROGI I I I I ! 

! 1 

1| NEXT DITP ! 

I 1 

21 10QP 

I 1 

31 LOGICAL DEVICE NUMBER I 

| j 

4| DLT PTR I 

| 1 

5| ILT PTR | 

| j 

6|RU|RU|SH|CEIDC| HARDWIRE STATUS I 

| ( 

7 1 ERROR STATUS I 

| 1 

8| TIMEOUT FLAGS I 

| 1 

91 TIMER REQUEST INDEX I 



IOT | 1111111111111111111111111 I PHYSICAL UNIT • 



13|RB4| RU | 
1 



DFLSG 

DUNK 
DIOOP 
DLDEV 
ODLTP 
DILTP 
DSTAT 
DSERR 
DTIIIE 
uTROX 
OUHIT 
DDF LAGS 



IOT - I/O Devices 

- non-HP-IB 

1 - HP-IB Systens 

3 - unused 

4 - unused 

DSAVE - Device processing flags. 
RU RUBIT - Indicates tape has been reuound. 
RU RUUNLD - Indicates that a rewind/unload uas perfomed to allow a 
urite-ring nount. 
■ A short read is in progress. After conpletion of read, 
EOF is checked for and if not present, the requested 
bytes are transferred f njn the short-read buffer to the 
user's buffer. 
CESTAT - Channel parity error processing is in progress. 
DSFLAG - Transfer used data chaining - used for computing the 
transnission log. 
RU - (DDflAGS, bit 15) if set, tape is reuound. 
RB4 - (bit 14) if set, need to rewind tape before next write. 
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PIT for 7976 Magnetic Tape 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



I I I I I I I FORUARDI BACK I 
R| Bl F| C-| El SI Ul SPACE I SPACE I RETRY 
i I I I I I ICOONTER ICOUNTER ICOUNTER 



There is one PIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the IOQ 
elenent. The following diagrati shows the DIT used for the nag tape driver. 



line re 

R - retry in progress 

B - backspace in progress 

F - forward space in progress 

G - gap in progress 

E - backspace on data end-of-file 

S - short read in progress 

U - unload tape for write ring installation 



1 2 3 4 5 S 7 8 9 10 11 12 13 14 15 

+—+—+—+—*—*— +~T 4 +--+—+--♦—+—+"+—+ 

OI OI OIACIRQI 0|mi| OIIOIIAI OI OI OI STATE I 



1| SYSDB relative pointer to the DIT for the next I 
I device requesting this resource or service i 
* 

21 SYSDB relative pointer to the first IOQ in 
I request list for this device 



MNEMONIC 
DF LAC- 
DUNK 



I DIOQP 

I 



Logical device nunber 



I 



4| SYSDB relative pointer to Device Linkage Tablel 
t + 

51 SYSDB relative pntr to Interrupt Linkage Tablel 



6|RU|RUISH| |DC|PF| 



I 



7| Hardware error status. Set uhen the driver I 
I detects an error. Whenever <X>, the driver j 
I nonitor logs an I/O error and clears this wordj 
4--4--4--4--4--4 + 

Z10I Bit is set at conpletion of tiner | 

+—+—4—+—*—+ + 

XI 1 L Interrupt status for this unit. Set by the I 
I driver each tine it processes an interrupt. i 



Physical unit N 



1121 IOT I II IIIII Ullll I III I 
! 

11 3 [ Holds the tine out request entry index while I 
I a tiner is active. I 

4 + 

Z14| Error log. Contains 5 valid bytes of status I 



DLDEV 
DOLTP 
PILTP 
DSAVE 
DSERR 

DTIHE 
OSTAT 



DRQST 
DLOGERROR 



DFIAG - Flags and request state 

- A Monitor is currently servicing this device. 

- A service request is pending while the nonitor is 
active. 

- This device is on a Multi-unit controller. 

- An I/O Channel Progran is running for this device. 

- An interrupt or response has occurred for this device. 

- Go to state £10 after Idle Channel Progran is started. 

- The device Monitor is starting an Idle Channel Progran 
for this device. There is no IOQ associated with this 
type of request. 
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AC 


ACTIVE 


RO 


REQUEST 


nu 


nUNIT 


10 


IOPROG 


1A 


IBK 


NO 


NOTRDV 


ST 


STUBIT 



I/O 



STATE - Stat* of the device nonitor. Specifies tht rant action 

to bt taken in SI0DH in servicing thl request: 

- start new request 

1 - not ut«d 

2 - c*ll driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

X10 - uait for interrupt (operator intervention) 

restart at state 
X11 - uait for data segment freeze, then state 2 
112 - uait for driver initiator to be frozen, then 

allocate controller (state 2! 
X13 - uait for I/O completion interrupt, then state 3 
X14 - uait for controller, then call driver initiator 
Z15 - not used 

X16 - uait for initiator nake present, then state 2 
3E17 - uait for conpletor nake present, then state 3 



DSRVE - Device processing flags 
RU RU8IT - Indicates tape has been rewound. 
RU RUUHLO - Indicates that a mind/unload Mat performed to allow a 

urite-ring mount, 
SH SHORT - fi short read i» in progress. Utter completion of read, 

EOT is checked for and if not present, the requested 

bytes are transferred fron the short-read buffer to the 

user's buffer. 



DC DSFLRG - Transfer used data chaining - 

transnission log. 
PF POUER - Device power up indication. 



used for conputing the 
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I /0 

DSTAT - 

BITS 



1 
2 

3 

4 
5 
6 

7 
8 
9 

10 

11 
12 



Rag tape controller status 

USE 

END OF FILE (EOF) 

BEGINNING OF TRPE (BOO / LORD POINT (LP) 

END OF TRPE (EOT) 

SINGLE TRACK ERROR (NOT LOGGED FOR RERDS) 

COIffiRNO REJECT (REJECT) 

FILE PROTECT (NOT WRITE ENABLED; HO URITE RING) 

nULTIPLE TRRCK ERROR (P.TE) 

UNIT ONLINE 

OCR (6250 BPI DENSITY) 

UNIT nuhser (RSB) 

UNIT NUNBER (LSB) 
TIHING ERROR 
TRPE RUNRURV 



13 REWINDING » 

14 UNIT BUSY » (REPORTED RS UNIT NOT READY) 

15 INTERFACE BUSY * 
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terd Reader pp 



2 
3 

4 

5 

6 

7 

X10 

111 

112 



12 3 4 5 



« 7 
•l-l — 

Ol 0|RCT|REQ| I I I I/O 
I I I I I I IPR06 



t 9 10 11 12 

■!-- -I— I- 



IRKIREADI NR| 
IDONEIRSGI 



15 

-I 



NSTRTE I DFLRS 



I 



DITP LINK TO NEXT DIT 



IOQP POINTER TO let REQUEST 



LOGICAL DEVICE NUMBER 



DRIVER LINKAGE TABLE POINTER 



INTERRUPT LINKAGE TABLE POINTER 



(SEE BELOU) 



ERROR STATUS IF HOT 



REQUESTED UORD COUNT 



/////////////////////////////////////////////////////////// 
IOT I/////////////////////////! PHYSICAL UNIT** 



OUNX 
OIOOP 
DLDEV 
DDLTP 
DILTP 
DSTAT 
DSERR 
DTII1E 
DTRQX 
DUNIT 



I/O 

Card Reader DIT Field Definitions 

Df LAG - Flags and device etate 

ACTIVE nonitor is currently active servicing this device. 

Service for this device uas requested while the nonitor uas active. 

SIO progran in progress. 

Interrupt occurred or request aborted or preenpted. 



REDDEST 
IOPROG 
IAK 
REROOONE 



DSTAT bits: 



BITO-SIO OK 
BIT1"0 

BIT2=INT PENDING 
BIT3=TI«.ING ERROR 
BIT4'UGnT OARK CHECK 
BITS 5-6 = 00 COLUHN BINARY RODE 
01 UNUSED 

10 PACKED BINARY HOPE 

11 HOLLERITH-TO-ASCII MODE 
BIT?=COHPARE ERROR 

BITS=EOF DETECTED 
BITS 9-10 • 00 NORHHL 

01 HOPPER EflPTY 

10 UNUSED 

11 STACKER FULL 
BIT11=INVAUD HOLLERITH 
5IT12"PICK FAIL OR HOTOR CHECK 
BIT13-TEST 

BIT14«TR0U8LE 
BIT1S»NPT REBDY 
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Previous read resulted in an EOF uith a backup save 
requested. The data has been saved in v\ auxiliary 
buffer and uili be passed back on the next read request. 

NRHESSAGE Set uhen a not ready nessage has been issued, and cleared 
when the reader is found ready. Used to prevent nultiple 
Hot Ready Massages uhen power is turned on. 

I1STBTE nonitor State. See SIOWI specifications for details. 

DUNK - SYSDB relative pointer to the DIT for the next device 
requesting service for this resource. 

DIOQP - SYSDB relative pointer to the first 108 elenent in the request 
list for this device. 



DLDEV - Logical device nunber and unit nunber. 

UNIT Unit nunber of device. 
LDEVN Logical device nunber. 

DDLTP - SYSDB relative pointer to driver linkage table (DIT). 



DSTRT - Device interrupt status. Contains the device interrupt status 
at the last interrupt. See hardware ERS for details. 

DSERR - Device interrupt error status. If not zero, then holds the 
device interrupt status fron an operation uith an erroneous 
conpletion status. Causes SIQDH to log an error. 



DUCNT - Holds the requested transfer count in words. 
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Device Infarction Table for HP-IB Z*rt Htfnr 

Then is ont DIT per physical device. If a physical device represent* nore 

th«n one logical device, the logical device nunber it obtained fron the I0Q 

elenent. The following diagran shout the PIT used for the card reader 
driver. 

1 2 3 4 5 6 7 $ 9 10 11 12 13 14 15 HNtnUNIC 



0| 0| OlflClRQi 0|nU| 0|IO|Ifl[NQ|ST| 0| STATE I 
+—+—■*—*—+— +—*—+—+--+— +--+--+ + 

1| SYSDB relative pointer to the DIT for the next) 
I device requesting this resource or service I 
t + 

2 1 IOQ table relative index to the first IOQ in I 
I request list for this device | 



OFLflC 
DUNK 



Logical device nunber 



i DLDEV 



3| 
+ + ♦ + 

4 | SYS06 relative pointer to Device Linkage Table | DDLTP 
+ + 

5| SYSD8 relative pntr to Interrupt Linkage Table! DIlTP 
+ + 

6 | RD | RF | I DSRVE 

+ + 

7| HardHare error status. Set when the driver | DSERR 
I detects an error. Whenever <>0, the driver | 
j nonitor logs an I/O error and clears this uordj 



I10| Not Used 



X1 11 



Request word count 



I DTiriE 

-+ 
i DUCNT 



Z12| IOT I/////////////////! Physical unit i | DUNIT 
| 1 

X13I Device Status. Read fron device during | DSTRT 

| each execution of the channel prog ran. j 

+ + 

214! Logging will be done fron here. ! DLOGERROR 

+ + 

DFLAG - Flags and request state 
AC ACTIVE - A Monitor is currently servicing this device. 
RQ REQUEST - A service request is pending while the nonitor is active. 



HUNIT - This device is on a nulti-unit controller. 
IOPRD& - Rn I/O Channel Progran is running for this device. 
IRK - Rn interrupt or response has occurred for this device. 

HOTRDY - Go to state X1Q after Idle Channel Progran is started. 
STUflIT - The device nonitor is starting an Idle Channel Progran 

for this device. There is no IOQ associated with this 

type of request. 
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STATE 



• State of the device nonitor. Specifies the next action 
to be taken in SIODH in servicing the request: 

- start new request 

1 - not uted 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request conpleted 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

110 - wait for interrupt (operator intervention) 

restart at state 
£11 - wait for data segnent freeze, then state 2 
X12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 
Z13 - wait for I/O conpietion interrupt, then state 3 
X14 - wait for controller, then call driver initiator 
XI 5 - not used 

X16 - wait for initiator nake present, then state 2 
Z17 - wait for conpletor nake present, then state 3 



DLDEV - Device logical device nunber 



IOT I/O TYPE 



I/O Systen type 

- Series II / III 

1 = HP-IB Systens 

2 = unused 

3 = unused 



I/O systen 



DSRVE - Device processing flags 
RD REAODONE - A card has already been read. 
RF BBQRTFLHG - A device clear has already been sent for 
this series of aborted IOQs. 
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2603 Line Printer DIT fHP-IB Systens) 



There is one DIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the IOQ 
elenent (however, there is only one device per 2608 controller.) The follow- 
ing diagran shows the DIT used for the 2608 line printer driver. 

1 2 3 4 5 6 7 i 9 10 11 12 13 14 15 

0| 0| OIACIRQ! 0| 0| 0|IO|IA|NO|ST| 0| STRTE I 



1| SYSDB relative pointer to the DIT for the next| 
i device requesting this resource or service | 
t i 

2 | IOQ table relative index to the first IOQ in | 
I request list for this device j 

+ + + + 

3l Logical device nunber | 

* + + + 

4| SYSDB relative pointer to Device Linkage Table] 
+ + 

S| SYSDB relative pntr to Interrupt Linkage Tablet 
+ + 

6|Vt1| | TRB I |PS|FL|TP| 



7| Hardware error pointer. Set when the driver | 
I detects an error. Uhenever <>0, the driver j 
j nonitor logs an I/O error and clears this wordj 
+„+ + * +— +--+--+ 

X10| Bit is set at conpietion of tiner I 

+— + ♦«- — + +—+—*—+ 

XI 1 | Holds the tine out request entry index while j 
I a tiner is active. I 

Z12J IOT I ///////////////// I Physical Unit « I 
t + 

Z13j Hardware logged error status | 



rWEhOHIC 

DFLflG 

DUNK 

DIOQP 

DLDEV 
DDLTP 
DILTP 
DSRVE 

DSERR 

DTItlE 
DRQST 

DUNIT 
DLOGERROR 



STATE - State of the device nonitor. Specifies the next action 

to be taken in SIODh in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request conpleted 

6 - initiate device recognition sequence 

7 - start operator intervention wait 

X10 - wait for interrupt (operator intervention) 

restart at state 

X11 - wait for data segnent freeze, then state 2 

Z12 - wait for driver initiator to be frozen, then 

allocate controller (state 2) 

Z13 - wait for I/O conpietion interrupt, then state 3 

Z14 - wait for controller, then call driver initiator 

X15 - not used 

Z16 - wait for initiator nake present, then state 2 

Z17 - wait for conpletor nake present, then state 3 

DLDEV - I/O systen type, unit and logical device nunber 
IOT I/O TYPE- Type of I/O systen 

- HP3000 Series II/III 

1 - HP3000 HP-IB Systens 

2 - unused 

3 - unused 

DSRVE - Device processing flags 
Vn vFCHOD - VrC has been nodified. 
TAB TRBDFRULT - Systen tab default. 
PS PRESPRCE - Last request used prespacing. 
FL FULL - Une printer buffer is full. 

TP TOP - Printer is at top of forn 



DFLAG - Flags and request state 



ACTIVE 

REQUEST ■ 

IQPRQG ■ 
IRK 

NOTRDY • 

STUflIT ■ 



R nonitor is currently servicing this device, 
fl service request is pending while the nonitor is 
active. 

An I/O Channel Progran is running for this device, 
fln interrupt or response has occurred for this device. 
Go to state X10 after Idle Channel Progran is started. 
The device nonitor is starting an Idle Channel Progran 
for this device. There is no IOQ associated with this 
type of request. 
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2608 line Printer Status 

BYTE 1 I BYTE Z: 
BITS USE 

ON UNI 

1 NOT REROY 

2 VFC CHANNEL 9 (BOTTOH OF F0RI1) 

3 VFC CHANNEL 12 (TOP OF FORM) 

4 VFC INITIALIZED 

5 6/8 LINES PER INCH 

6 <NOT USEO) 

7 POWER RESTORED/UNIT RESET 
i ON UNE 

9 PRINT flECH ERROR 



10 
11 
12 

13 
14 

15 

BYTE 3: 
BYTE 4: 



BYTE 6: 
BYTE 7: 
BYTE S: 
BYTE 9: 
BYTE 10: 
BYTE 11: 
BYTE 12: 
BYTE 20: 



SELF TEST FAILURE 
PAPER ERROR 
SELF TEST NODE 

6/8 IPI 

PLATEN/RIBBON ERROR 
(NOT USED) 

PRINT MODE 

BITS 0-7 I100E NUBER 

PRMBRY/SECOHDARY 

BITS 0-3 SECONDARY CHARACTER SET CODE 

BITS 4-7 PRIMRY CHARACTER SET CODE 

SELF TEST 

BITS PASS FAIL 

BITS 1-7 SUBTEST HUH8ER 

6 LPI DOT ROU COUNT 

6 LPI FORI! LINE NUBBER 

6 LPI FORI! LENGTH IN LINES 

8 LPI DOT ROU COUNT 

8 LPI FORH UNE NWIBER 

8 LPI FORH LENGTH IN LINES 

FIRHUARE IDENTIFICATION CODE 

POUER-UP LANGUAGE 

BITS 0-3 SECONDARY CHARACTER SET CODE 

BITS 4-7 PRWBRY CHARACTER SET CODE 
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HP 2619A or 26 13 Lin. Print.r PIT (HP-IB Svstens) 

There is one D1T per physical device. If e physical device repreeente 
(tore then one logical device, the logical device nunber it obtained 
f ron the IOQ elencnt (however, there is only one device per 2631 
controller.) The following diagran shows the DIT used for the 
2631 line printer driver. 

1 2 3 4 5 6 7 t 9 10 11 12 13 14 15 flNEdOHIC 
+"+—+—+--♦--+—+—+--+—+—+—+—+—+—+—+—♦ 
0| 0| 0|AC|RQ| 0| 0| 0|IO|IA|NO|ST| 01 STATE | DFLSG 

+--+—+— +—+—4— +—+--+— 4 — +--+--+ 1 

11 SYSDB relative pointer to the DIT for the next I DUNK 
I device requesting this resource or service j 
* 1 

21 100 table relative index to the first IOQ in I OIOQP 
I request list for this device j 

t ♦ 1 , 

3| Logical device nunber | DLDEV 

t 1 1 , 

4| SYSDB relative pointer to Device Linkage Tablel DOLTP 
t * + 

51 SYSOB relative pntr to Interrupt Linkage Tablel DILTP 
t _ + 

61 |BJ|AB|PS|FL|TP| DSAVE 
+ 1 

7| Hardware error status. Set when the driver | DSERR 
j detects an error. Uhenever <>0, the driver j 
I nonitor logs an I/O error and clears this wordj 

+ + 

Z10| Bit is set at conpletion of tiner | OTIflE 

+ + 

Z11| Holds the tine out request entry index while I DRQST 
I a tiner is active. I 

Z12| I0T I/////////////////I Physical unit « I OUNIT 



Z13| 



Hardware logged error status 



I DLOGERROR 



DFLAG - Flags and request state 
AC ACTIVE - A nonitor is currently servicing this device. 
RQ REQUEST - A service request is pending while the nonitor is 

active. 
ID IOPROG - An I/O Channel Progran is running for this device. 
Ifl IAN - An interrupt or response hae occurred for this device. 

NO NQTRDY - Go to state 110 after Idle Channel Progran is started. 
ST STUflXT - The device nonitor is starting *n Idle Channel Progran 

for this device. There is no IOQ associated uith this 

type of request. 
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STATE - Stats of the device nonitor. Specifies the next action 

to be taken in SI0OT1 in servicing the request: 

- start new request 

1 - not used 

2 - call driver initiator procedure 

3 - call driver conpletor procedure 

4 - not used 

5 - process request completed 

6 - initiate device recognition sequence 

7 • start operator intervention wait 

210 - wait for interrupt (operator intervention) 

restart at state 
Z11 - wait for data segnent freeze, then state 2 
Z12 - uait for driver initiator to be frozen, then 

allocate controller (state 2) 
Z13 - uait for I/O conpletion interrupt, then state 3 
Z14 - uait for controller, then call driver initiator 
Z15 - not used 

Z16 - uait for initiator nake present, then state 2 
Z17 - wait for conpletor nake present, then state 3 

DLDEV - I/O systen type, unit and logical device nunber 
IOT I/O TYPE - Type of I/O systen 

- HP3000 Series 2/3 

1 - HP30O0 HP-IB Systens 

2 - Unused 

3 - Unused 

DSAVE - Device processing flags 



I/O 



HP 2680A/2688R DIT 

1 2 3 4 S 6 7 t 9 10 11 12 13 14 15 

+— +--4— +«4--t™+™+~+— +— 4 — ♦—+—+—+—+ — 4 

OITO 10 10 IRCfRQiO !0 !SP!CP!IR!NR(SII! ! STATE ! DFLAG 



POINTER TO NEXT DIT 



INDEX TO RCTIVE 100 OR ZERO 



LOGICAL DEVICE NtfflBER 
DRIVER LINKAGE TABLE POINTER 
INTERRUPT LINKAGE TABLE POINTER 



! DUNK 

! DIOQP 

! DLDEV 

! DOLTP 

! DILTP 



SPECIAL ERROR CONDITIONS TO BE LOGGED 



! ERROR LOGGING INFORIWTION 

!T ! TiriEOUT INDICATION IN BIT 

! TWER REQUEST INDEX (TRL) OR ZERO 



! DSTAT 

! DSERR 

! DTIHE 

! DTRLX 



BJ BETJOB 



PS 


PRESPRCE 


FL 


FULL 


TP 


TOP 



' Between jobs flag. If set, suppress 

Ponerfail Message. 
' Ftbort (caused by Pouerfail or Operator) 

has occurred. 

Last request used prespacing. 

Line printer buffer is full. 

Printer is at top of fom 



10 ! IOT !/////////////////! 

■ 

11 ! 

12 ! 



PHYSICAL UNIT N 
CURRENT DATA URITE BYTE COUNT 



13 ! 



CURRENT DATA UORD COUNT 
It OF UORDS LEFT TO TRANSFER 
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! DUNIT 

I DCBCNT 

! OCUCNT 

! ORCNT 

14 ! BUFFER OFFSET FOR NEXT II OF UORDS TO XFER. ! DOFFSET 

15 ! !D! DDEBUG 

16 ! I/O STATUS BLOCK UORD 1 GETS LOGGED FROtl HERE ! DLTJGBUFFER 

17 I I/O STATUS BLOCK UORD 3 GETS LOGGED FROH HERE ! 

18/33 ! I/O STATUS AREA (16 UORDS, SEE DEFINITION) ! DIOSTAT 



0FLR6 - DEVICE RELATIVE FLAGS. 

AC ACTIVE BIT. 1 II1PLIES A NONITOR CURRENTLY 

SERVICING THIS DEVICE. 
RQ REQUEST BIT. 1 IHPUES SERVICE REQUESTED 

UHILE HONITOR IS ACTIVE. 
SP SIO PREEHPTION. IF SET THEN A PREEHPiIVE 

REQUEST HAS BEEN QUEUED FOR THIS DEVICE. 

PREEflPT CODE IS SET IN IOQ ELEHENT. 
CP CHANNEL PROGRM IN PROGRESS. IF SET, THEN 

H LhAMlEL PROGRRB IS CURRENTLY EXECUTING. 
IP IF SET, m INTERRUPT OR RESPONSE HAS OCCURRED. 
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NR 



HSTATE 



IF SET, DEVICE IS IK B NOT READY DR OPERBTOR URIT. 
IF SET, RH IDLE CHRNNEL PROGRAM SHOULD BE STARTED 
FOR THIS DEVICE. 

CURRENT DRIVER STRTE RS DEFINED BY THE HONITOR. 
ALLOUABLE STRTES RRE: 

- START REQUEST 

1 - NOT USED(BUT RESERVED) 

2 - CALL DRIVER INITIATOR 

3 - CALL DRIVER COMPLETOR 

4 - UNUSEDSBUT RESERVED! 

5 - COMPLETE REQUEST.. PERHAPS RETURN TO USER. 

6 - UNEXPECTED INTERRUFT OCCURRED. 

7 - START OPERRTOR INTERVENTION URIT. 
X10 - UAITING (ON OPERBTOR). RESTART AT 0. 

11 - UAITING (OBTA I1AKEPRESENT/FREEZINC-) 

12 - UAITING (INITIATOR CODE MBKEPRESENT/FREEZE) 

13 - UAITING (FOR COMPLETION INTERRUPT) 

14 - UAITING (FOR DEVICE CONTROLLER AVAILABILITY) 

15 - UNUSED (BUT RESERVED) 

16 - UAITING (INITIATOR CODE HAKEPRESENT) 
1? - UAITING (COMPLETOR CODE HAKEPRESENT) 

DLDEV - I/O SYSTEM TYPE, UNIT AND LOGICAL DEVICE NUMBER. 
IOT I/O SYSTEM TYPE. 

- HP3000 SERIES II/III (SIO/DIO) 

1 - HP-IB Systens 

2 - RESERVED 

3 - RESERVED 

DCBCNT - CURRENT BYTE COUNT TO BE TRANSFERRED. 

DCUCNT - CURRENT UORD COUNT TO BE TRANSFERRED. 

DRCNT - REMAINING UORD COUNT TO TRANSFER. 

DOFFSET - OFFSET IN BUFFER OF NEXT • UORDS TO TRANSFER. 

DDEBUG - IF BIT 15=1 THEN DEBUGGING INFO UILL BE SENT TO CONSOLE 

DL0G8UFFER - STATUS UORDS 1 i 3 ARE MOVED HERE TO BE LOGGEO 
IF THEY U£RE LOGGED FROM THE I/O STATUS BLOCK 
THEIR CONTENTS MIGHT BE CHANGED BEFORE THEY 
UERE LOGGED. 

DIOSTRT - I/O STATUS RREA 16 UORDS, SEE I/O STATUS BLOCK DEFINITION. 
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I/O ftltw BtpcK 



1 2 3 4 S 6 7 I 9 10 11 12 13 14 15 






!0 !- 


-THE ' 


OR' 


OF UORDS 1/16 IS LOCATED HERE—-! 


1 


!OF!HS!PU!PE!TE! !!!!!! 


i 


i 


1 1 1 


2 


i i 


i i 


l 


! (RESERVED) ! ! 


I 


i 


1 1 1 


3 








DCS FRULT NUHBER 






1 


4 


!CL!F 


L!VL!CU!FU!VU!IL!IP!ST!SB!IR!HP!W!NH!TL!NC! 


5 


!LP!Pf!NC! 


i 


! (RESERVED) ! ! 


! 


i 


1 1 1 


6 


i i 


i i 


! 


! (RESERVED) ! ! 


i 


I 


1 1 1 


7 


i i 


i i 


! 


• (RESERVED) ' ! 


1 


i 


1 1 1 


S 


i i 


1 ! 


! 


! (RESERVED) ! ! 


1 


i 


1 1 1 


9 


i i 


I 1 


! 


! (RESERVED) ! ! 


i 


! 


1 1 1 


10 


i i 


1 1 


1 


! (RESERVED) ! ! 


1 


1 


1 1 1 


11 


i i 


1 1 


I 


\ (RESERVED) ! > 


1 


1 


1 I 1 


12 






RECORD NUftSER OF ERROR 






1 




♦-- 






IF UORD 4 IS 






— + 


13 








NON-ZERO 






! 


14 


! SHEET NUMBER OF ERROR IF UORD 4 IS NON-ZERO ! 




♦— 






OR 






— + 


15 


! LAST SHEET TRANSFERRED IF "JOB" 


& POUER-ON ! 



1! 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 



■ EACH BIT IS THE 'OR' OF ONE UORD IN THE TABLE (EXCEPT 
BIT UHICH IS NOT USED). THEREFORE, BIT .(1:1) IS SET 
IF UORD 1 IN THE TABLE IS NON-ZERO. 

• BIT= - (OF) ONLINE/OFFLINE BIT. 

1 - (MS) MESSAGE BEING DISPLAYED ON THE 2680H/26S8A CONSOLE. 

2 - (f>U) POUER UP COMPLETED SINCE LAST I/O STATUS READ. 

3 - (PE) PRRITY ERROR DETECTED ON PHI COMMAND. 



6/15 • 



(TE) TRANSMISSION ERROR DETECTED IN THE PRINTER. 
RESERVED. UNUSED. 



UORD 2 - NOT USED. RESERVED. 

UORD 3 - MCS FAULT NUMBER. CONTAINS AN INTEGER DESCRIBING THE LAST 
FAULT TO OCCUR SINCE THE LAST TIME THE I/O STATUS UAS READ 
OR THE HP 26S0A/26SSA UBS POUERED DOUN. IF THE UORD IS ZERO THERE 
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IS NO MCS FAULT. SEE DCS ERS FOR R DESCRIPTION OF THE MCS 

FAULT NUMBERS. 

• BIT* - (CL) NO ROOM FOR ATTEMPTED CHARACTER SET LOAD. 

1 - (FLJ NO ROOM FOR ATTEMPTED FORM LOAD. 

2 - (VL! NO ROOM FOR ATTEMPTED VFC LOAD. 

3 - (CU) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED CHARACTER SET. 

4 - (FU) ATTEMPT TO SELECT AN UNDEFINED FORM SET. 

5 - (VU) ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED VFC SET. 

6 - (10 ATTEMPT TO PRINT DATA AND THERE IS NO CURRENTLY 

SELECTED LOGICAL PAGE TABLE (LPT) ENTRY. 

7 - (IP) ATTEMPT TO MOVE PEN OFF THE LOGICAL PAGE. 

S - (ST) THE 26800/2688A COULD NOT PROCESS ALL OF THE DATA 
BEFORE IT UAS SUPPOSED TO BE TRANSFERRED TO THE 
DRUM/PAPER. DATA UBS LOST! 

9 - (SB) SPOOLER BLOCK CONTAINS FORMAT ERROR. 

10 - (IR) INVALID RECOVERY BLOCK RECEIVED FROM SPOOLER. 

11 - (MP) MAXIMUM NUMBER OF COPIES PER PHYSICAL PAGE 

HAS BEEN EXCEEDEO. THIS IS A RESULT OF THE 
SPOOLER PROCESS SETTING THE MAXIMUM COPIES PER 
PAGE UITH FUNCTION CODE 132. 

12 - (NJ) A COMMAND OR FUNCTION CODE UAS RECEIVED UHEN NO 

"JOB" UAS IN PROGRESS. THE COMMAND OR FUNCTION UAS 
IGNORED BY THE DCS. 

13 - (KM) HO MEMORY. 2680B/2688B DYNAMIC MEMORY ALLOCATION HAS 

DETECTED THAT MAIN MEMORY IS COMPLETELY OCCUPIED UITH 
CHARBCTER SETS, VFC'S, FORMS AND DATA SUCH THAT THE 
2680A/2688A CANNOT PROCESS THE CURRENT INPUT DATA. DATA 
UILL BE LOST! 

14 - (TL) ATTEMPT TO PRINT DATA AND THERE RRE MORE THAN 

THE MAXIMUM BLLOUABLE LOGICAL PAGE TABLE (LPT) 
ENTRIES SELECTED. 

15 - (HC) R NON-EXISTENT VFC CHANNEL UAS SKIPPED TO. 

■ BIT= - (LP) LOGICAL PAGE TRUNCATED TO FIT PHYSICAL PAGE. 

1 - (PF) PAGE SIZE REQUIRED BY PROGRAMMER DID NOT 

MBTCH PAGE SIZE SET BY OPERATOR. OPERATOR PAGE 
SIZE PREVAILS. 

2 - (NC) NO CHARACTER SET SELECTED. 
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IN ADDITION, UHEN A POUER FBIL OCCURS DURING A "JOB", 
THE POUER ON BIT IS SET IN UORD ONE AND THE SHEET 
NUMBER OF THE LAST SUCCESSFULLY TRANSFERRED PAGE IS 
PLACED HERE. THIS INFORMATION IS FOR USE BY THE 
SPOOLER SHOULD A RECOVERY OF A "JOB" BE DETERMINED. 
THESE UORDS OCCUR IN "JOB" ONLY. 



ALL UOROS OF THE I/O STATUS RRE CLEARED UHENEVER THE STATUS BLOCK 
IS RETURNED TO THE HOST. IT IS UP TO THE HOST CPU TO RETAIN ANY 
ONGOING STATUS BITS REQUIRED. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



I0Q3 !«B!RB!HB!IO!TO! 



! XFER ! PARITY j ! OMISC 



UORDS 6/11 



NOT USED BUT RESERVED FOR FUTURE USE. 



UORDS 12/13 - THE RECORD NUMBER UHICH CONTAINS THE OFFENOING ERROR 
BS DEFINED BY UORD FOUR. IF A POUER FAIL OCCURS DURING 
A "JOB", THE POUER FAIL BIT IS SET AND A SHEET NUMBER IS 
MADE AVAILABLE IN UORDS FOURTEEN AND FIFTEEN. HOUEVER, 
THE RECORD NUMBER IS LOST AND CRHNOT BE REPORTED. THESE 
UORDS OCCUR IN A "JOB" ONLY. 

UORDS 14/15 - THE SHEET NUMBER ON UHICH THE ERROR OCCURRED AS DEFINED 
BY UORD FOUR. IF AN ERROR OCCURS IN THE ENVIRONMENT FILE 
AT THE START OF R "JOB", THEN THIS NUMBER UILL BE ZERO. 
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UHERE: 
.(0:1) - MB 



.(1:1j - KB 

.(2:1) - AB 

.(3:1) - 10 

.(4:1) - TO 

.(5:4) - RESERVED 

.(9:3) - XFER 

.(12:3)- PARITY 

.(15:1)- RESERVED 



USER REQUESTED TRANSFER IN EXCESS OF 4096 
UORDS. THE DRIVER CAN URITE UP TO 4096 UORDS 
TO THE 2680B/2688A. IN ORDER TO HANDLE UP TO 32K 
UORDS, MULTIPLE URITES PRE USED UITHOUT A 
RETURN TO THE USER UHO CALLED THE DRIVER. 
THIS BIT INDICATES THAT MULTIPLE URITES ARE 
BEING DONE TO THE 2680A/2688B. 



THE CURRENT URITt BLOCK MUST BE RETRIED. 

USER REQUESTED RBORT IN PROGRESS FLAG. 

I/O STATUS HBS BEEN READ AND IS AVAILABLE. 

GENERAL I/O CONTROLLER TIMED OUT. 

NOT CURRENTLY USED. 

2680A/2688A TRANSFER ERROR COUNTER. 

CHANNEL PROGRAM COMMAND PARITY ERROR COUNTER. 

NOT CURRENTLY USED. 



"NOTE" IN THE ABOVE, SINGLE BIT FIELDS ARE AS DEFINED 
UHEN THE BIT IS A LOGIC "1". 
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Pitt Request Table and. Disc Requests 



Requests for disc transfer* are effected by acquiring an entry fron the Disc 

Request Table (DISCREuTAB), filling the proper information, and calling the 

DISCOTIANnGER to link the request into the device's doubly linked request qu 

queue. 

The head and tail of a device's request queue are contained in the 

devices' PIT. 



MttRMTSe 




♦~>| 
I 



First I 
Request I 
j in Queue |<> + 

I 

! 



I Next 
I Request 
I in Queue 



I Last 

->l Request 

I in Queue 



<> ♦ 

I 
I 

■♦ i 

|<> + 
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Disc Request Table 

0ISCREQTA8 DST ENTRY* ' 56 (Z70) 
DISCREQTAB HIT * Z1017 



Disc Request Table Entry Fortiat 

1 2 3 4 5 6 7 ! 9 10 11 12 13 14 15 

|„|-.|"|-|-I"I~M-M--|-I--|--I~|-I 

OISCREOTSeoOl TOTAL ENTRIES I 

|.„„„„,„ ,„.«-,„ 1 

PISCREQTSB01 1 ENTRY SIZE (X21) | 

| 1 

piscR£QT(ieo2i pwjiary entries i 

, . 1 

DISCREQTAB03I inPEOED PROCESS PCB | 

I I 

0ISCREQTR6MI TRBLE INPEX OF HEAD OF AVAILABLE ENTRV LIST I 
| 1 

MSCREQTAW5I TABLE INDEX OF TAIL OF AVAILABLE ENTRV LIST I 
1 1 

0ISCREQTRBO6I nAX ENTRIES IN USE I 

| 1 

PISCRE0TAB07I CURRENT ENTRIES IN USE I 

| 1 

0ISCRE0TAB08I OVERFLOUS I 

| 1 

0ISCREQTBB09I | 

I TOTAL REQUESTS I 

0ISCREQTR81OI | 

| 1 

OISCREBTfleillSVSBASE INDEX OF HEAD Of DISABLED RED Q | DISC9HEAD 

| 1 

DISCREQTAB12ISYSBBSE INDEX OF TAIL OF DISABLED REQ Q I DISCQTAIL 

I I 

DISCREQTA613I SERIAL WRITE QUEUE HEAD I SERU9HEAD 

I I 

DISCREQTAB14IA I ///////////////// I HAX. SERIAL URITE QUEUE I A ■ Active 
|... 1 

0ISCREQTAB15I///////////////////////////////////////////////I 
| . 1 

0ISCREQTrei6|///////////////////////////////////////////////| 
| . 1 
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Disc Request Elenent Format 



1 2 3 4 5 t 7 i 9 10 11 12 13 14 15 

Uord OOIA IK ID IS II IB |C ID in |Q IS IP IC ID IL II 

IB in II IB |0 IK |Q |A IB |U II IF IU II ID IN 

|0 |R |A IU IU |0 in IT IE IE 10 |A IK IS IR |L 

|R |E |G IF |A | IP |A |R IU |F II |R IA | |0 

IT ID I I IK | I IF IR IE ID IL IE IB I IC 

I I I I IE I I I I I II I IQ I I |A 

! I I ! I ! I I I I IL I I I I |L 

| 

Uord 01 1 REQUEST URGENCY CLASS 

Uord 021 LOGICAL DEVICE MIBER 
| 

Uord 031 MISCELLANEOUS 



I- 



Uord 041 SI 



DST 

BflHK 



(IF PROCESS DISC I/O) 
(IF SEGMENT TRANSFER) 



Uord 05| OFFSET INTO DATA SEG (IF PRXESS PISC I/O) 

i ADDRESS IN BANK (IF SEQUENT TRANSFER) 
| 

Uord (Mil UNIT It | FUNCTION 

| 

Uord 07| COUNT/XLOG/CONTROL RETURNS 

| 

Uord 081 P1 (HOPA IF SEGTIENT TRANSFER 

| 

Uord 09| P2 (LOOA IF SEGTIENT TRANSFER 

| 

Uord ID!//////////////////////////! QUALIFIER I STATUS 
I 

Uord 11IFREEI PCB NUNBER 



Uord 121 



Uord 131 

I- 
Uord 141 



Uord 151 



INDEX OF PREV REQUEST IN QUEUE 
INOEX OF NEXT REQUEST IN QUEUE 



SEOIOENTIFIER (IF SEG TRANSFER) 



I- 



Uord 16IDISPLACENENT OF READ OR URITE FRON SEG BASE(M) 



I- 



URGCLASS 
LDEVN 

wsc 

DSTN 
S-STACK 

ADDR 

FUNC 
XFERCNT 

PRR1 

PAR2 

STAT 

PCBN 

PREVREQP 

NEXTREQP 

SEGMENT 

SEGDISP 
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(lord - QFLAG - Request dependent flags 

Bit .RBORT Request has been aborted externally. 

Request is for a segment transfer. 

Diagnostic request (not used). 

Systen Buffer. Target is a system buffer 

whose index is relative to the start of 
the S8UF table. 

Make caller on completion of request. 

Blocked I/O. Caller is uaited in ATTACHIO until 
request is completed. 

Request has been completed and caller woken if 
he had specified. 



Bit 1 


.imAEQ 


Bit 2 


.DIAG 


Bit 3 


.SBUF 


Bit 4 


.IOUAKE 


Bit 5 


.BLOCKED 


Bit 6 


.COBPLETEO 



.ORTRFRZN 



Data segnent has been nade present and is 
frozen. 



Bit S 


.HATIERROR 


Bit 9 


.PREQOUEU 


Bit 10 


.SFAIL 


Bit 11 


.PFAIL 


Bit 12 


.CURREQ 


Bit 13 


.DISABLED 


Bit 14 


.LOR 


Bit 15 


.INLOCAL 



Note: Upon return to free list, uord (#1) becomes index of next EE 
free entru. 
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HAFI error on data segnent make present. 

.PREQOUEUED Request is queued into disc's req queue 

Start SIO failure in GIP. 

The I/O has been aborted because of a powerfa.il. 

Request is device's current request. 

Request is disabled. 

Request in local DRQ. 

Buffer DST is in process locality. 

Uord 2 - QLOEV.QLDEVN - Logical Device Number 
Uord 3 - QniSC - Device dependent. 

Uord 4 

QDSTN - If SYSBUFRs is clear then this is the PST nunber of the target 
data segnent. If bit is set then buffer address is a DG offset 
value instead of segnent relative offset (implemented for 
NOUAIT 10 and NOBUFF). 

Uord 5 

QADDR - Offset in data segment sr sys buff tsbit tc target data buffer. 

Uord i 

QFUNCFUHC - Function code and qualifiers as specified by driver. 
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Uord ? 

QXFERCNT-On initiation specifies the uord count if positive or byte 

count if negative. At conpletion of the request this location 
contains the actual transnission count in the sane units as the 
call. Certain control requests return data through this 
location. 
Uord S 

QPAR1 - Paraneter one, defined by driver 
Uord 9 

UPRR2 - Paraneter tuo, defined by driver 

QflISC - Hiscellaneous request dependent storage available to driver. 
Uord 10 

QSTAT.PCBN - PCB Nunber of process uhich nade this request. Zero if 
not associated uith any process and IOQ is to be returned 
by the systen. 
.QUALIFIER - P. code uhich further defies or qualifies the 

general status. Defined by driver. 
.STATUS - General Status. Indicates current and result state of 
the request according to the following codes. 

- not started or auaiting conpletion. 

1 - successful conpletion. 

2 - end of file detected. 

3 - unusual condition. 

4 - irrecoverable error. 

BOTE: See I/O Systen Status Returns, 

Uord 11 - bit 0=1 Q elenent is on free list. 
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IOQ Table Layout 




1 
2 
3 

4~ 

I 
5- 

6 
7 

10 

11 

12 
13 



TOTAL * 



ENTRY SIZE 



PRMARV * 



IBPEOED PROCESS PCB 



nnxinun of in use 



CURRENT IN USE 
OVERFLOWS 



TOTAL REQUESTS 
UNUSED 



THEAO 
TTAIL 

TUSE 



INDEX OF 5 
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I/O 



108 (Cont.) 



I/O Queue Elenent (IOQ) 



ENTRV 4 
(IN USE) 



1 2 3 4 5 S 7 S 9 10 11 12 13 14 15 
l-l-l-l-l-l-l-l-l-l-l-l-l-l-l-l- 
I REQUEST DEPENDENT FLAGS 



IOQ POINTER 



QLDEVN 



31 



MISCELLANEOUS 



4|S I 

I 
| 

I 
51 
| 

el 

I — 

7| 
| 

SI 

I — 

9| 

I- 



DATA SEGHENT DST NUHBER 



UNIT • | FUNCTION 

COUNT/XLOG/CONTROL RETURNS 



P1 
P2 



10 1 /////////////////////// 1 QUALIFIER I STATUS 
i 

PCBN 



11IFRI 
| 



QFIflG - Request dependent flags 



OF LAG 
QUHK 
QLDEV 

gmsc 

QDSTN S(Uord 4(0:1) 
Stackflag If set 
QflDOR is DO rel. 

QADOR 

QFUNC 

OUBCT 

QPAR1 
QPAR2 
QSTAT 
QPCBN 
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Bit 
Bit 1 



.ABORT 
.SPECIAL 



Bit 2 


-MAG 


Bit 3 


.S8UF 


Bit 4 


.IOUAKE 


Bit 5 


.BLOCKED 


Bit i 


.C011PLETE0 



Request has been aborted externally. 

Special handling is to be applied to this 
request. For disc, indicates a nenory 
nanagenent request. 

Diagnostic request (not used). 

Systen Buffer. Target is a systen buffer 
whose index is relative to the start of 
the SBUF table. 

Uake caller on conpletion of request. 

Blocked I/O. Caller is waited in fiTTRCHIO until 
request is conpleted. 

Request has been conpleted and caller uoken if 
he had specified. 
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I It 


I/O 




US.txm llmmftm,) 


I/P 5yi«" SWm Kitvmi 




Bit 7 .BATRFR7.H Data segnent hit been Mill present and it 


- PENDING 


STATUS X 


frown. 








1 - UAITING FOR COMPLETION 


10 


Bit 8 .hTWIERROKD llflll error on data segnent HeRe present. 


2 - DOING ERROR RECOVERY 


20 




3 - NOT READY WAIT 


30 


Bit 9 .PREQ Thit request has been started but ues preenpted 


4 - NO URITE RING UAIT 


40 


by a MAM request. 


5 - NEU PAPER TAPE UAIT 


50 


Bit 10 .SFAIL Start SIO failure in HP. 


1 - SUCCESSFUL 




Bit 11 .PFRIL The I/O has been aborted becaute of a pouerfail, 


- NORMAL 


1 


Bite12-13 .PREEMPT Preenptive type code: 1-eoft, 2-hard. 


1 - READ TERMINATED UITH SPECIAL CHARACTER 


11 




2 - TAPE RETRY FOR SUCCESS REQUIRED 


21 


Bit 16 .MSQDQNE R neosage request reply hat completed. 


3 - LOU TAPE OR END OF TAPE AFTER URITE 


31 


OUHK - Table relative index of next 109 elenent. Point! to first 






word of elenent. 






QLDEV - Logical Device Nunber 


2 - END OF FILE 




OniSC - Device dependent. 








1 - PHYSICAL END OF FILE 


12 


QOSTN - If SYSBUFRs is clear then this is the DST nunber of the target 
data segnent. If bit is set then buffer address is a OB offset 


2 - DATA 


22 


3 - END OF DATA 


32 


value instead of segnent relative offset (inpienented for 


4 - HELLO 


42 


NOUAIT 10 and NOBUFF). 


5 - BYE 


52 


0RD0R - Offset in data segnent or sys buff table to target data buffer. 


6 -JOB 


62 


QFUHC.FUNC - Function code and qualifiers as specified by driver. 


7 - END OF JOB 


72 


QUBCT - On initiation specifies the word count if positive or byte 






count if negative, fit completion of the request this location 






contains the actual transnission count in the sane units as the 


3 - UNUSUAL CONDITION 




call. Certain control requests return data through this 






location. 


1 - TERMINAL PARITY ERROR 


13 


QPAR1 - Pareneter one, defined by driver 


2 - TERMINAL READ TIMED OUT 


23 


0PAR2 - Paraneter tue, defined by driver 


3 - I/O ABORTED EXTERNALLY 


33 


QMISC - Miscellaneous request dependent storage available to driver. 


4 - DATA LOST 


43 


QPC8N - PCB Hunker of process uhich ntde this request. Zero if 


5 - DATA SET MOT READY OR DISCONNECT 


53 


not associated uith any process and I0Q is to bo returned 


OR UNIT NOT ON LINE 




by the systen. 


6 - ABORTED BECAUSE OF POUER FAIL 


63 


.QUALIFIER - R code uhich further defies or qualifies the 


7 - BOT AND BSR, BSF REQUEST 


73 


general status. Defined by driver. 


10 - TAPE RUNWAY 


103 


-STATUS - General Status. Indicates currant and result stats of 


11 - EOT AND URITE REQUEST 


113 


the request according to ths following codes. 


12 - NO URITE RING AFTER REQUEST TO OPERATOR 


123 


- not started or awaiting conplstion. 


13 - END OF TAPE (PAPER TAPE LOU) 


133 


1 - successful conpletion. 


14 - PLOTTER UNIT SUITCH REACHED 


143 


2 - end of file detected. 


16 - ENABLE SUBSYSTEM BREAK AND NO CONTROL Y PIN 153 


3 - unusual condition. 


16 - READ TIME RETURNED OVERFLOU 


163 


4 - irrecoverable error. 


17 - BREAK STOPPED READ 


173 




20 - URITE AND NO CARD IN UAIT STATION 


203 


(lord 11 bit 0- Queue elenent is on free list. 


21 - DEVICE POUERED ON - OPERATING ENVIRONMENT LOST 213 




27 - VFC HAS BEEN RESET 


273 
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I /0 


I/O 




I/O Svsten Status Returns (Cont.) 


I/O Queue Elenent for 7976A Naonetic Taoe 


4 - IRRECOVERABLE ERROR 


1 2 3 4 S 6 7 1 9 10 11 12 13 14 IS 


MNEMONIC 






► 


- INVALID REQUEST 4 


01 Request dependent flags (see belou) 


OF LAO 


1 - TRANSMISSION ERROR 14 






8 - I/O TIME OUT 24 


11 SYSDB relative pointer to next IOQ elenent. 


QUNK 


3 - TIMING ERROR 34 


1 Points to first word of elenent. 




4 - SIO FAILURE 44 


+ * 




5 - UNIT FAILURE 54 


21 logical device nunber 


QLOEV 


6 - INVALID DISC ADDRESS 64 


4»^ a **4-A.«4. B 4 BB .«.f B >XH.»l H » 4fe . A la«,« rt(v 




7 - TAPE PARITY ERROR 74 


3| R| B| F| G|BO| TDUTI FSCNTR J BSCNTR f RTCNTR 


onisc 


11 - PAPER TAPE TAPE ERROR 114 






12 - SYSTEM ERROR 124 


4| S| If QFLRM3.1) is clear then this is the 


QOSTN 


13 - INVALID S8UF INDEX 134 


( | DST nunber of the target data segnent. If 




14 - CHANNEL FAILURE, TIMEOUT OR NO RESPONSE FROM 144 


I | S is set, QROOft is D6 relative. 




CONTROLLER 






15 - UNINITIALIZED MEOIB (LINUS) 154 


5| Offset in the data segnent or systen buffer 


QAODR 


16 - NO SPARE BLOCKS AVAILABLE 164 


I table to the target data buffer. 




17 - OELETED RECORO DETECTED ON IBM FLOPPY DISC 174 






20 - LABELED DEVICE UNAVAILABLE AFTER REELSUITCH 204 


6 | | Function code for 


QFUNC 


21 - PARITY ERROR DETECTED ON PHI COMMAND (EPOC) 214 


j | this request. (See 
) j next section.) 




5 - ERROR IN DATA CONTROL INFORMATION 




XLOG 


7 | On initiation, specifies the uord count (>0) 


QUBCT 


- INVALID ITEM NUMBER 5 


I or byte count (<0). fit conpletion of the 




1 - INVALID ACCESS FOR ITEM IS VALID ACCESS 


j request this location contains the actual 




2 - FAILURE IN FOPEN OR FREAO 25 FS ERROR NUMBER 


j transnission count in the sane units (bytes 




3 - PARITY CHANCE IN S BIT MODE 35 


j or words) as in the request. 




4 - INVALID INFO FILE FORMAT 45 






S - CHECKSUM ERROR IH INFO FILE 55 


3.101 Paraneter 1. Used only for reads. Contains 


QPAR1 


E - PASSED VALUE LESS THAN MIN. E5 MIN. VALUE ALLOUED 


j the EOF specification in bits (13:3). 




7 - PASSED VALUE GREATER THAN MAX. 75 MAX. VALUE ALLOUED 
10 - PASSED VALUE IS UNSUPPORTED 105 






Z11| Paraneter 2. Used only for urites. If bit 


QPAR2 


11 - COUNT LESS THAN REOUIRED TO 115 MIN. SPACE NEEDED 


I (13:1) is set, uniting past EOT is allowed. 




RETURN ALL INFO. 






12 - COUNT GREATER THAN AVAILABLE 125 MAX. SPACE AVAIL 


X12I///////////////////////I QUALIFIER 1 STATUS 


QSTRT 


TO STORE INFO. 






13 - PASSED VALUES NOT IN ASCENDING 135 OFFSET OF ELEMENT 

ORDER 

14 - PASSED CHARACTER HAS OTHER 145 OTHER FUNCTION 


1131 PCS NUMBER 






DEFINED FUNCTION 


QFLAG - Request dependent flags 






Bit RBORT - Abort this request and return an er 


-or indication to the 




caller. 






Bit 1 SPECIAL - Apply special handling to this re 


uest. (Not used) 




Bit Z DIAG - This is a request fron the diagno 
(Not used) 
Bit 3 SYSBUFF - Target u an index relative to thi 


tic subsysten. 




SBUF Table of 




the data buffer. 






Bit 1 TCUAXE Ma'ie calZer -r ccnpleticr :r rsqys 






Bit 5 BLOCKED - Blocked I/D. The caller is uaitet 


'in HTTBCHIO 


CM .00 


G.01,00 
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13- 64 





I/O 


I/O 




until the request it conpleted. Inplie* IOUAKE. 


I/O Queue Eltnent (100) for CIPER 


Bit 6 CDBFLETED - The request has been completed and the caller 






auakened if he had requested (with IOUAKE). 


1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


menoHic 


Bit 7 DflTAFRZH - Set by the nenory nanagenent routines (UAH) when a 






rtflKEPRESENT request is successfully completed and 


0| Request dependent flags (see belou) 


Of mo 


indicates the data segnent is frozen in nenory. 


♦--+—■+--♦—■+--+--+--+ — t — +—+--+—+--+ — +--+ — 




Bit 8 RfiHERRQRD - fin error has occurred uhile HAM uas trying to 


1 | IOQ table index to the next IOQ elenent. 


CLINK 


nake the target data segnent present and freeze 
it in nenory. 


I Points to first word of elenent. 








Bit 9 PREQ - (Not used) 


2 1 Logical device nunber 


GLDEV 


Bit 10 SFAIL - Delayed failure of SIG instruction. If a call to 








START'HPIB resulted in the request being added to 


3| 


wis: 


the channel queue, this bit indicates that the SIO 








instruction failed when the request uas selected 


4| ! If QFLAG,(3:1) is clear then this is the 


8DSTN 


for execution. 


I SJ DST nunber of the target data segnent. If 




Bit 11 PFHIL - The request uas aborted because of a systen power 


I | S is set, QADDR is DB relative. 




failure. 






5| Offset in the data segnent or systen buffer | QADDR 


QI1T.SC - Driver request dependent flags and counters. Used nostly for 
error retries. 


I table to the target data buffer. 




61 I Function code for 


OFUNC 


RETRY - Indicates an error retry is in progress. 


\ | this request. (See 




BACK - Backspace record processing for an error retry is in 


1 | next section. ) 




progress. 






FORUARD - Forward space record processing for an error retry is 


7| On initiation, specifies the word count (?0) 


QU8CT 


in progress. 


I or byte count (<0). At conpletion oF the 




GAP - Gap processing for an error retry is in progress. 


j request this location contains the actual 




BODEQF - Backspace record due to a data EOF processing is in 


1 transnission count in the sane units (bytes 




progress. 


1 or words) as in the request. 




TOUTCHTR - GIC tined-out counter. 
FSCNTR - Forward space record counter. 






X10) Parameter 1. 


QPP.R1 


BSCHTR - Backspace record counter. 








RTCNTR - Error retry counter. 


Z11| Paraneter 2. 


6PAR2 
USTBT 


2121 I QUALIFIER jRSTATUS 


QSTAT - PCB nunber and request completion status. 










Z13j PCBN 


opce 


PCBN - The Process Control Block (PCB) nunber of the process 








which nade this request. If zero, the request is not 






associated with any process and the 100 elenent is to 






be returned by the systen when the request has conpleted. 


QFLAG - Request dependent flags 




STATUS - General status indicating the final state of the request. 






The following codes are used: 


Bit ABORT - Abort this request and return an error indication 


- Not started or awaiting conpletion. 


to the caller. 




1 - Successful conpletion. 


Bit 1 SPECIAL - Apply special handling to this 


request. (Not used) 


2 - End-of-file detected. 


Bit 2 DIAG - This is a request fron the diagnostic subsystem . 


3 - Unusual, but recoverable, condition detected. 


Bit 3 SYSBUFF - Target is an index relative to the SBUF Table of 


4 - Irrecoverable error has occurred. 


the data buffer. 




QUALIFIER - R code which further defines or qualifies the general 


Bit 4 IOUAKE - Uake caller on conpletion of request. 


status. (See the section Oriver Return Status Codes. ) 


Bit 5 BLOCKED - Blocked I/O. The caller is waited in ATTACHIO 




until the request is conpleted 


Inplies IOURKE. 




Bit 6 COMPLETED - The request has been conpleted 


and the caller 




awakened if he had requested (with IOUAKE). 




Bit 7 DATAFR2N - Set by the nenory nanagenent routines (HAH) uhen a 


G.01.00 


G.01 .00 
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13- 66 




I/O 


I/O 




MAKEPRESENT request is successfully conpleted and 


- Pending 1 - Waiting For Conpletion 210 


indicates the data segnent is frozen in nenory. 


3 - Not Ready Uait 


IX 


Bit 8 MAMERRORD - fin error has occurred uhile Mflrt was trying to 






nake the target data segnent present and freeze 


* - Successful - He Errors 


Zi 


it in nenory. 






Bit 9 PREQ - (Not used) 


2 - End of File (Not Used) 




Bit 10 SFfllL - Delayed failure of SIO instruction. If a call to 






STRRTIO resulted in the request being added to 


3 - Unusual Condition 3 - Request Aborted 


Z33 


the channel queue, this bit indicates that the SIO 


6 - Pouerfail Abort 


Z63 


instruction failed when the request was selected 


Z21 - Device Powered Up 


1213 


for execution. 






Bit 11 PFRIL - The request uas aborted because of a systen power 


4 - Irrecoverable Error - Invalid Request 


a 


failure. 


1 - Transfer Error 


X14 




2 - I/O Tined Out Before Conplete X24 




4 - SIO Failure 


Z44 


QSTflT - PCB nunber and request conpletion status. 


5 - Unit Failure 


X54 




XI 2 - Systen Error 


X124 


PCBN - The Process Control Block (PCB) nunber of the process 


Z14 - Channel Failure 


Z144 


which nade this request. If zero, the request is not 


Z21 - Parity Error 


1214 


associated with any process and the IOQ elenent is to 






be returned by the systen uhen the request has conpleted. 






RSTRTUS - General status indicating the final state of the request. 
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The following codes are used: 






- Not started or awaiting conpletion. 


1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


FIHEnONIC 


1 - Successful conpletion. 


+—+—+—+— +—+—4— +—+—+—+—*--+— +—t~+— 




2 - End-of-file detected. 


0| Request dependent flags (see belou) 


OFLflG 


3 - Unusual, but recoverable, condition detected. 


+--+--+«*■-- +--+—+--+— ♦-- ♦—*—+—♦—+—+— +-- 




4 - Irrecoverable error has occurred. 


1 | SYSDB relative pointer to next IOQ elenent. 


QLINK 


QUALIFIER - A code which further defines or qualifies the general 








status. (See the section Driver Return Status Codes.) 
HP-IB CIPER Physical Driver Reauest Codes 
OPERATION FUNCTION PARAMETERS 


21 Logical device nunber 


OLDEV 
QfllSC 

(DSTN 


3|PP|PE|HC|T01ITCNTR| I UPITCODE 


4| S| If 8FlflG.(3:1) is clear then this is the 




I I DST nunber of the target data segnent. If 






I I S is set, QflODR is DB relative. 




READ None 






5| Offset in the data segnent or systen buffer 


QRDDR 


URITE 1 None 
FILE OPEN 2 None 


I table to the target data buffer. 


OFUNC 


6 | I function code for 




I I this request. (See 




FILE CLOSE 3 None 
DEVICE CLOSE 4 None 


I 1 next section.) 


OUBCT 


71 On initiation, specifies the uord count (>0) 




1 or byte count (<0). fit conpletion of the 




CIPER INIT 184 None 


1 request this location contains the actual 
1 transnission count in the sane units (bytes 




CIPER Driver Return Status Codes 
General Status (13:3) Qualifying Status (8:5) Overall (8:8) 


I or nords) as in the request. 


QPRR1 


X10I Paraneter 1. Vertical Fornat specification. 




I (See next section for detail. ) 
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G.01 .00 
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13- a 


i 



I / 



X11I Ptrantter 2. Span ltedt Flag*. 
I notion for details.) 



(See ntxt I 0PAR2 
I 



m\llllllHlllllllllllllli\ qualifier I status i bstat 



1131 



PCS NW8ER 



I OPCBN 



OFLAG - Requett dependent flags 
Bit ABORT 



Bit 1 
Bit 2 



SPECIAL 
DIAG 



- Abort thit request and rttum an error indication 
to the caller. 

- Apply tptcial handling to this request. (Not uicd) 

- Thit it a request fron the diagnottic subsystem. 
(Not uted) 

• Target if an index relative to the SBUF Table of 
the data buffer. 

- Utke caller on conpletion of request. 

- Blocked I/O. The caller is uaited in BTTfiCHIO 
until the request is completed. Inpliea I0UAKE, 

Bit 6 CONPLETED - The request has been conpleted and the caller 
awakened if he had requested (uith IOUAKE). 



Bit 3 SVSBUFF 



Bit 4 
-Bit 5 



IOUflKE 
BUCKED 
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' Set by the nenory management routines (AAA) when a 
— IEPRE! — " " • " ' ' 



Bit ? DP.TPFP.ZN 

NAKEPRESENT request it tuccestfully conpleted and 

indicate* the data segment is frozen in nenory. 
Bit 8 nANERRORD - An error has occurred uhiie HAD utt trying to 

nake the target data tegnent present and freeze 

it in nenory. 

- (Not used) 

- Delayed failure of SIO instruction. If a call to 
STARTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIO 
instruction failed uhen the request uas selected 
for execution. 

- The request uas aborted because of a oyster, power 
failure. 



Bit 9 PREO 
Bit 10 SFAIL 



Bit 11 PFAU 



BnTSC - Driver request dependent flags and counter*. 

PRE'TO'POST - Pre to post spacing change flag. 
PEJECT - Last operation uas a page eject. 

IWSTERCLR^ - (latter clear done to clear powerfail bit in status. 

(latter clear needs to be done fron not ready condition. 
TOUTCNTR - Channel tine-out retry counter. 
HHITCODE - Indicates type of uait: 

- neu request 

1 - conpletion uait 

2 - not ready uait 



QSTOT - PCB number and request conpletion status. 



PCBN 



STATUS 



QUALIFIER 



The Process Control Block (PCB) nunber of the process 
uhich nade thit request. If zero, the request it not 
ittociated uith any procctt and the I0Q elenent it to 
be returned by the eystem uhen the request has conpletad. 
General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

- R code uhich further defines or qualifies tht general 
ttatut. (See the notion Driver Return Status Codsf.) 



0.01.00 
13- 70 



I/O 
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Operation 
URITE 



Function 

1 



FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

READ STATUS X17 



VFC SET 



X100 



2608 Lin* Printer Request Code* 



P1 - Vertical Fomat Specification 
1 - uss 1st data char at fomat spec 

X53 - "+", print and suppress spacing 
XS5 - "-", print and triple space 
Z60 - "0*, print and double space 
X61 - "1", print and top of form 

1200-2277, print and space N-X200 lines 
X300-X377, print uith channel H-Z277 

All others, print and single space. 

P2 - Space node Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(14:1) - No page stepover flag 
if set, single and double space 

uithout stepover (66 lines/page) 
if clear, single and double space 
uith stepover (60 lines/page) 

Page eject if not at top of font 

Page eject if not at top of form 

Page eject if not at top of forn 

Read I/O status 
Count - buffer nust be at least 2 bytes 

Load VFC RAH 
Count - forn length in words 

(0 loads RAH forn internal ROD) 
P1 - 6 for 6 LPI or S for 8 LPI 

any other value defaults to 6 LPI 

Sets logical column definition 
P1 - to 15, any other value defaults to 15 



261 W * 2631 Line Printer IM Elenent (HP-IB Svstens) 



1 2 3 4 5 6 7 > S 10 11 12 13 14 15 

♦—♦—♦—♦"+"+"+—+ — >--♦-- +—+—+-- +--+--+« + 
01 Request dependent flag* (stt below) I 

t— ♦—+"+"+"+"+--+--+--♦"+— +--♦—+"♦"+--+ 

1 1 SYSD6 relative pointer to next IOO elenent. I 

I Points to first word of elenent. I 



21 



Logical device nunber 



I 



3IPPIPEIPF | TOUTCHTR I | UAITCOOE I 

4| SI If QFLRG.(3:1) is clear then this is the I 
I I OST nunber of the target data segnent. If I 
I | S is stt, QADOR it DO relative. I 

#-_+ + 

5f Offset in the data segnent or system buffer I 
I table to the target data buffer. I 



I 



I Function code for 
I this request. (See 
I next section.) 



KNEnONIC 
OF LAO 
OLINK 

QLDEV 
QMSC 

ODSTN 

OADDR 
QFUNC 



7| On initiation, specifies the uord count (>0) ! QM8CT 

I or byte count (<0). At conpletion of the ! 

I request this location contains the actual 

I transmission count in the sane unite (bytes I 

I or words) as in the requeet. i 



X10| Parameter 1. Vertical Fomat specification. 
I (Stt next notion for detail. ) 



XII I Parameter 2. Space Node Flage. (See next I 
I ttction for detailt.) j 



X12I///////////////////////I BUAUFIER I STATUS I 



X13I 



PCB NUIISER 



QPAR1 
QPAR2 

BSTRT 

OPCBx 
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QFLAG - Request dependent flags 

Bit ABORT - Abort this request and return an error indication 

to the caller. 
Bit 1 SPECIAL - Apply special handling to this request. (Not used) 
Bit 2 QIAG - Thic is a request fron the diagnostic subsystem. 

(Not used) 
Bit 3 SVSBUFF - Target is an index relative to the SBUF Table of 

the data buffer. 
Bit 4 ICURKE - Wake Ciller on conpletis" or request. 
Bit 5 BLOCKED - Blocked I/O. The caller is waited in MTfiCHIO 

6.01.00 
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I/O 



until the request is conpleted. InpUes IQUAKE. 
Bit 6 COilFLETED - The request has been completed and the caller 
auakened if he had requested (with IOURKE). 



OATAFRZN - Set by the nenory nanagenent routines (flfifl) when a 
nHKEPRESEKT request is successfully completed and 
indicates the data segnent is frozen in nenory. 
Bit S llfiflERRORD - fin error has occurred uhile UAH uas trying to 
nake the target data segment present and freeze 
it in nenory. 
(Net used) 

Delayed failure of SIO instruction. If a call to 
STfiRTIO resulted in the request being added to 
the channel queue, this bit indicates that the SIC 
instruction failed uhen the request uas selected 
for execution. 

The request uas aborted because of a systen pouer 
failure. 



Bit 7 



Sit 9 PREQ 
Sit 10 SFRIL 



Bit 11 PFAIL 



QtlISC - Driver request dependent flags and counters for 2631. 



PRE'TO'POST ■ 
PEJECT 

TOUTCNTR 
PQHERFAIL ■ 
URITCODE 



Pre to post spacing change flag. 

Last operation uas a page eject. 

Channel tine-out retry counter. 

Pouer fail flag indicates pouer fail occurred. 

Indicates type of uait: 

- neu request 

1 - conpletion uait 
1 - not ready uait 



G.01.00 

13- 73 



I/O 

Fomat for 261 9fi 
12 3 4 



12 



15 



|PP|PE|PF|TQ|BF| 



I URITCODE I 



TOUT 
BUF'FILL 



Channel tined out flag 
■ Buffer fill operation in progress 



QSTRT - PCB nunber and request conpletion status. 

PCSN - The Process Control Block (PCB) nunber of the process 
which nade this request. If zero, the request is not 
associated uith any process and the IDQ elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

- Not started or awaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes. ) 
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2619 Line Printer Request Codes 



I/O 



2631 Line Printer Request Codes (HP-IB) 



Operation Function 
WRITE 1 



Operation Function 
WRITE 1 



FILE OPEN 


2 


FILE CLOSE 


3 


DEVICE CLOSE 


4 


READ STATUS 


117 


•IDENTIFY 


Z110 


*SELF TEST: 
INITIATE 


1111 


STATUS 


Z112 


'LOOPBACK TEST: 
URT DATA Z113 
READ DATA 1114 



P1 - Vertical Fomat Specification 
1 - Use 1st data char as fomat 
specification. 

X53 - "+", print and suppress spacing 
X55 - "-", print and triple space 
XGO - "0", print and double space 
X61 - "1", print and top of fom 

22O0-X277, print and space N-X200 lines 
Z300-Z312, print uith channel N-2277 

2320 - Fill Line Printer Buffer Only 

Rll others, print and single space. 

P2 - Space (lode Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(14:1) - No page stepover flag 
if set, single and double space 

without stepover (66 lines/page) 
if clear, single and double space 
with stepover (60 lines/page) 

Page eject if not at top of fom 

Page eject if not at top of fom 

Page eject if not at top of fom 

Read I/O status 
Count - buffer size 

Return ID value in Bank & Buffaddr 



Subtest nunber to execute in Bank and Buffaddr 

(subtest nunber ranges fron to 7) 
Subtest result returned in Bank 4. Buffaddr 



Data to LP in Bank 4 Buffaddr [PING] 

Data fron LP read into Bank 4 Buffaddr [PONG] 

Count - Buffer Size (256 bytes nax) 
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FILE OPEN 2 

FILE CLOSE 3 

DEVICE CLOSE 4 

READ STATUS 117 



VTC SET 



1100 



P1 - Vertical Fomat Specification 
1 - Use 1st data char as fomat 
specification. 

153 - "♦", print and suppress spacing 

X55 - "-", print and triple space 

260 - "0", print and double space 

X61 - "1", print and top of forn 

X200-X277, print and space N-X200 lines 
X300-X307, print uith channel N-Z277 

X320 - Fill Line Printer Buffer Only 

Rll others, print and single space. 

P2 - Space node Flags 

(15:1) - Prespace flag 

if set, print then fill buffer 
if clear, fill buffer then print 
(14:1) - No page stepover flag 
if set, single and double space 

uithout stepover (66 lines/page) 
if clear, single and double space 
uith stepover (60 lines/page) 

Page eject if not at top of fom 

Page eject if not at top of fom 

Page eject if not at top of fom 

Read I/O status 
Count - 1 byte nininun required 

LOADS VFC Rftfl 

P1 - 1 - 1 LPI (lines per inch) 

2 - 2 LPI 

3 - 3 LPI 

4 - 4 LPI 

5 - 5 LPI 

6 - 6 LPI 
8 - 8 LPI 

12 - 12 LPI 

Any other value defaults to 6 LPI. 
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I/Q Emu Hitwn< rV HP-H CH Mriir 

1 2 3 4 B S 7 S 9 10 11 12 13 14 15 IWEHONIC 

4--4--+--4--4--4--4«4-.*--4--4--4--4--4--4--4--4 
0| Requett dependant flag* (m belou) | QFLRG 

♦"+"+«*«♦—♦«*«+«♦«+—.+--+"♦"♦"+"*—+ 
1 1 SVSOB relative point«r to next IN tltntnt. I SUNK 

I Points to first uord of element. ! 

t................ ........4.. + 

2 1 Logical device nunbtr | QLOEV 

4..4--4..4.-4..4— -.4->4- 4 4 + 

3 1 Auxiliary bufftr fleg. | 0J1ISC 

+..+..+..+..+..#.....4..... — + +. 4 

41 SI If 0/1*5,(3:1) it elttrthen thi« if the | QOSTN 
DST number of tin target date eegnent. If 

i I S it ttt, QBOOR it W relative, j 

,..« . 1 

51 Offeet in tin data segment or oyeten buffer | OA0OR 
I table to the target data buffer. ! 

4 4 .., 

61 I Function cede for | OFUNC 

i I thie rtquttt. (See I 

I I nut itction. ) | 

4 4 ......„.......4 

71 On initiation, specifies tht uord count (>0) 1 8U8CT 

I or byte count (<0). lit completion of tht I 

I rtquest thit location contain! tin actual I 

I transmission count in tha sane units (bytte I 

I or words) at in tht rtqutit. ( 

4 , 

X10| Paranattr 1. Contain! the EOT aptcificttion I 0PAR1 

4 4 

X1 11 Paranattr 2. Contains the data noot I QPAR2 

I spteification in bits (11:2). (See belou card I 
I rtadtr request codas for detail information) I 

X12l///////////////////////T~"0URLIr : ieii T'STBTUS'T BSTBT 
4 4... ........4 ...4 

xi 3 i pee KuneER i dpcbn 

I 1 

OFLRC - Request dependent flags 

Bit BBCWT - Abort this request and return an irror indication 

tc the caller. 
Bit 1 SPECIAL - Apply special handling tc this request. (Hot ussd) 
Bit 2 DIAO - This is a requeet fron the diagnostic eubeyttsn. 
Bit 3 SVSBUfF • Target ie an index relative to the SSUf Table of 

the data buffer. 
Bit 4 lOWKE - Ueki caller on conpiltion of requeet. 
Bit 5 BLOCKED - Blocked I/O. The caller it uaited in ATTACHIO 

until the request is consisted. Inpliae IOUAKE. 
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Bit fi COWLETED ■ Tht rtquttt hat bein computed and the caller 
auekenod if ht had requeued (uith IOUAKE), 

Bit 7 DATAFR2N - Set by tht ntnory management routinta (UAH) uhen a 
rtSKEPRESENT request ii luccissfully conpleted and 
indicate! the data aegnent ie frozen in memory. 

Bit 8 rlBTIERRORO - fln error has occurred uhile RAH uai trying to 
next the target data tegmtnt preeent and freeze 
it in nenory. 

Bit 9 PREQ - (Not uied) 

Bit 10 SFP.IL - Delayed failure of SIO instruction. If a call to 
STRRTIO resultsd in tht request being added to 
the channel queue, this bit indicant that tht SIO 
instruction failed uhen tht rtqutit uas ttltcttd 
for execution. 

Bit 11 PFAIL - Tht request uai aborted becautt of a System pouer 
failure. 



OfllSC - Auxiliary buffer flag uied to indicated a read into tht 
driver's bufftr and not tht uter'i buffer. 



OSTRT - PCB nunber and rtquttt eonplttion status, 

PCBH - Tht Process Control Bloc* (PCB) nunber of tht proceet 

uhich nade thie request. If aero, the rtquttt it not 
associated uith any pretest and tht 100 tltntnt it to 
bt rttumtd by the eytten uhen the requeet has conpleted. 
STATUS - General status indicating the final etate of the requeet. 
The following codes are ueed: 

- Not ttarttd or auaiting conpletion. 

1 - Succettful eonplttion. 

2 - End-of-filt dettcttd. 

3 - Unutual, but recoverable, condition detectid. 

4 - Irrecoverable error hai occurred. 

QUALIFIER - P. code uhich Further definti or qualifitt the general 
etttut. (Stt tht itction Drivtr Return Status Codtt.) 
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II 



CS BO Ditc Reauett Queue Elenent (100) 



1 2 3 4 5 6 7 I 9 10 11 12 13 14 15 

4................... .... . . 4 

01 Requeet dependent fltge (tee btlou) I 

4... . . . 4 

1 1 Requeet urgency class j 

4 4 4 

2 1 Logical device nunber | 

4— 4--4--4— 4 — 4 4 — 4 — > 4 4 

3|CHnW|RS|01>|ln|SR!RTRAR|LF|SP| I IMITCOM I 



OST 
DST 



(If process disc I/O) 



ItHEIBNIC 

OF LAO 

CURGCLASS 

OLOEV 

onisc 

QOSCTN 



41 SI 
I--- 
I 

4— +- 

5| Offset in the data teg (If process disc I/O) I (MOOR 



(If segment transfer) [S'Steck] j 



I 

I Bddrsss in Bank (If segnent transfer) 



61 Unit It 

I 



I Function code for 
I this request. 



7| On initiation, specifitt the uord count (>0) 

I or byte count (<0). At eonplttion of tht 

I request this location contains tht actual 

I transmission count in tht taut unitt (bytei 

I or uords) at in tht request. 



OFURC 
QU8CT 



' Rsqusst has bien aborted ixttmally. 

• Requeet ie for a segnent transfer. 

■ Thie is a requeet fron the diagnoatic lubiystsn. 

- Target ia an index relative to the SBUF Table of 
the data buffer. 

• Uake caller on conpletion of rtquttt. 

■ Blocktd I/O. The caller ie ueited in ATTACHIO 
until the requett ie conpleted. Inpliit IOUfiKE, 

■ The requeet hat bttn conpleted end the caller 
auakened if he had requeued (uith IOUAKE). 

• Data aegnent hai been prtstnt and ie frozen. 

■ An error hae occurred uhile MAIt uas trying to 
make the target data segnent preeent and freeze 
it in nenory. 

■ Requett it queued into diec't requeet queue 

- Delayed failure of SIO instruction. If a call 
to StARTIO resulted in the request being added 
to the channel queue, this bit indicates that 
the SIO instruction failed uhen the request uas 
selected for execution. 

- The request uas aborted because of a tystsn 
pouer failure. 

' Request is device's current requist. 

■ Requeet it ditebltd. 

' Attempt to dieable this requeet. 

- A nessaga request reply hae conplctid, 



QPAR1 



X 81 P1 - Parameter 1 (Usually High Order of I 

I Current Logical Oiac Address [CLDA1]) | 

4 4 

X 9 1 P2 - Parameter 2 (Usually Lou Order of I QPAR2 

I Current Logical Disc Address [CL0A2]) | 

X»0 | //////////////////////" rQUHUFIER | "STATUS" I OSTAT 

21 1 j PCB * * ' "| JP6C 

+ - ♦ 

X12I Sysbasc relative indx of prtvious req in queue I QPREVREOP 

4 ._ 4 

2131 Sytbatt rtlativt indx of next nq in quiut I ONEXTREQP 

* 4 

X14| | QSEGIDENT 

»- Segidentifier (If it; tranifir) — t 

2151 | 



XIEIMSPLACEnEKT DF READ OR URITE FROK SEC BASE(lttl)| OSEWISP 



(FLAG • Sesuett depenteri flags 
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Bit ABORT 

Bit 1 IHIREQ 

Bit 2 DIRG 

Bit 3 SBUF 

Bit 4 IOUAKE 

Bit S BLOCKED 

Bit 6 CONPLETED 

Bit 7 DATAFR2N 

Bit 8 nmERRORD 



Bit 9 PREQUEUEO 
Bit 10 SFAIL 



Bit 11 PFAIL 

Bit 12 CUAREQ 
Bit 13 DISABLED 
Bit 14 DISATIIPT 
Bit 15 HS50ONE 



OLOEV, OLDEVN - Logical Device Number 

SKISC - Driver request dependent Flags and counters. 

CHAH'ERR'FLG - Channel error retry flag. 

RSTAT'FAIL'FLO - Requeet etatus Failed flag. 

OPER'REQ'FIG - Operator requested release flag. 

In' FRUIT' FIG - Internal maintenance fault flag. 

STAT'RTRVFLG - Status error single retry flag. 

RTRANS'FLO - Retranenit required flag. 

LOAD'FLG - hedia load flag. 

SYS'PFAIL'FLG - Systen pouerfail flag. 

UAITCODE - Indicates type of uait: 

• neu rtquest 

1 - conpletion uait 

2 - not ready uait 

3 - releaie/rcleaee deny uait 

4 - IOQ defer uait 

5 - DSCT read uait 

6 - DSCT urite uait 

7 - synchronization uait 

JOS'" - If lyiten buffir ii clear then thia ia the DST 

miNttpr «• 4nf tiirart riir* aegH#n* T# pit c. \« 

set then buffer address is a DB offset value 
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instead of segnent relative offset (inplenented 
for NQUAIT I/O and N08UFF). 

QADDR - Offset in data segnent or systen buffer table to 
target data buffer. 

OFUNC - Function code and qualifiers as specified by 
driver. 

QSTRT - PCB nunber and request conpletion status. 

PCBN - The Process Control Block (PCB) nunber of the process 
uhich nade this request. If 2ero, the request is not 
associated with any process and the IQQ elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 

- Not started or awaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes, ) 
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CS 80 Integrated Cartridge Tape . Reque st 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 MNEnQNIC 
i, 

I OFLAG 
-+ 
I QURGCLfiSS 
+ 

i QLDEV 
t + 

1 ufliTCODE | onisc 

* + 

t QDSCTK 



Request dependent flags (see belou) 



1 | Request urgency class 
+ + 

2| Logical device nunber 

+ 4 — 4-- +-- 4 *— 4— + 

31CHANF|RS|0P[IH| RE1RY |LF|SP| 

4 4—4— 4—4 4—4—4 

4j SI DST (If process disc I/OJ 



DST (If segnent transfer) [S=Stack] | 



5 | Offset in the data seg (If process disc I/O) I QADQR 



I- 

| Address in Bank (If segnent transfer) 



61 Unit it 

I 



I Function code for | 
I this request. 



QFUNC 
OUBCT 



7 | On initiation, specifies the uord count (>0) | 

I or byte count (<0). fit conpletion of the \ 
I request this location contains the actual 

I transnission count in the sane units (bytes j 

t or uords) as in the request. I 

+. + 

Z10| P1 - Paraneter 1 (Usually High Order of | QPBR1 

I Current Logical Disc Address [CLDR1]) I 

4 + 

Z11| P2 - Paraneter 2 (Usually Lou Order of I QPAR2 

I Current Logical Disc fiddress [CLDA2]) I 

4- 

Z12I 



PCBN 



| QUALIFIER I STATUS | 



QSTAT 

Z13| Sysbase relative indx of previous req in queue! QPREVREQP 
+ + 

OXEXTREQP 

OSEGIDEHT 

Z16I Oisplacenent of read or urt fron seg base (nil)! QSt'GDISP 

Z17IS I////////////////////////////////////////////I 

I U I////////////////////////////////////////////I 

IB I////////////////////////////////////////////I 

IP I////////////////////////////////////////////! 



Z14| Sysbase relative indx of next req in queue | 
+ 

Z15| Segidentifier (If segnent transfer ! 



QFLAG - Request dependent flags 
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Bit RBORT 

Bit 1 HI1REP, 

Bit 2 DIAG 

Bit 3 SSUF 

Bit 4 IOUAKE 

Bit 5 BLOCKED - 

Bit 6 COMPLETED - 

Bit 7 OATAFRZN - 

Bit 8 tlAflERRORD - 



Bit 9 PREQUEUED 
Bit 10 SfRIL 



Bit 11 PFAIL 

Bit 12 CURREfl 
Bit 13 DISABLED 
Bit 14 DISHTMPT 
Bit 15 nSGDONE 



Request has been aborted externally. 

Request is for a segnent transfer. 

This is a request froti the diagnostic subsysten. 

Target is an index relative to the SBUr Table of 

the data buffer. 

Hake caller on conpletion of request. 

Blocked I/O. The caller is uaited in ATTRCHIO 

until the request is conpleted. Inplies IOUAKE. 

The request has been conpleted and the caller 

auakened if he had requested (with IOUAKE). 

Data segnent has been present and is frozen. 

fin error has occurred uhile flRtt uas trying to 

nake the target data segnent present and freeze 

it in nenory. 

Request is queued into disc's request queue 

Delayed failure of SIO instruction. If a call 

to STRRTIO resulted in the request being added 

to the channel queue, this bit indicates that 

the SIO instruction failed uhen the request uas 

selected for execution. 

The request uas aborted because of a systen 

pouer failure. 

Request is device's current request. 

Request is disabled. 

flttenpt to disable this request. 

A nessage request reply has conpleted. 



I/O 



instead of segnent relative offset (inplenented 
for KOURIT I/O and NOBUFF). 

Qh'DDR - Offset in data segnent or systen buffer table to 
target data buffer. 

QFUNC - Function code and qualifiers as specified by 
driver. 

QSTAT - PCB nunber and request conpletion status. 

PC8M - The Process Control Block (PCB) nunber of the process 
uhich nade this request. If zero, the request is not 
associated uith any process and the IOQ elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 

- Not started or auaiting conpletion. 

1 - Successful conpletion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 

4 - Irrecoverable error has occurred. 

QUALIFIER - A code uhich further defines or qualifies the general 
status. (See the section Driver Return Status Codes.) 



QLDEV. GL0EVN - Logical Device Nunber 

QtlISC - Driver request dependent flags and counters. 



CHflN'ERR'FLG - 

RSTfiT'FHIL'FLG - 

OPER'REQ'FLG • 

IH'FRULT'FLG - 
RETRY' COUNT 
LOAD'FLG 

SYS'PFAIL'FLG ■ 

UfliTCODE 



Channel error retry flag. 
Request status failed flag. 
Operator requested release flag. 
Internal naintenance fault flag. 
Retry count ana. 
■ Hedia load flag. 
Systen pouerfail flag. 

Indicates type of uait: 

- neu request 

1 - conpletion uait 

2 - not ready Hait 

3 - release/ release deny uait 

4 - IOQ defer uait 

5 - DSCT read uait 

6 - DSCT urite uait 

7 - synchronization uait 



QOSTN - If systen buffer is clear then this is the DST 
nunber of the target data segnent. If bit is 
set then buffer address is a D6 offset value 
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5ME.Hm_Uraa 



total • 
entry sue 



PRIIWRYN 



IBPEOEO PROCESS PCI 



HEfitJ IHMX 



TAIL INDEX 



RAHIMIOF IN UK 



CURRENT IK USE 
OVERT LOW 



TOTAL 
REQUESTS 



INDEX OF 5 



ENTRY 2 

INDEX OF 1 



ENTRY 3 



INDEX OF 2 



ENTRY 4 
(IN USE ) 



INDEX OF 4 



ENTRY! 



TSHE 

THIRD 
TTBIl 
TUSE 

TOVRFL 
TRUSTS 



1 - t - S - 4 - 2 
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TltltElBM.ltRUM.tlon (Cunt.) 

Kequ.it typtt 2 ml 3 nturn tn indication to tht calltr if tht nque.t 
could not bt eati.fied. Tht following table ip«lfi« tht typo of colli 
for tltntnt allocation and tht action if an alintnt ia not tctivatad. 



BUFFER USER 

SBUF'l 

Flit tytttn 
Ptapt 
Bad track 

108'. 

ATTACHIO (not inpedeblt) 
ATTACHIO (inptdablt) 
SI00F1 (ntnory nanagtntnt) 
lOhtSSACE 

HERDER DEFINITION 



CALL TYPE 



Inptdt 

Inpedt 
Print ry 



Prinary 
Inptdt 
Steondary 
Secondary 



FINAL ACTION 



Forget raquttt 



Rtturn IOOX-0 



Suddtn dtath 
I/O trror 



Prinary * - Hunbtr of tlintnte in tht prinary araa. 

Total I - Total ntmbtr of elenent. in tht tablt. 

Silt - Silt in uord. of aach alintnt. 

Inptdtd PCB - If not nro thin contain, tht PCB nunber of thi 

firtt proem waiting for an altnant in thi. tabla, 

Haad index - Indix of firtt frtt tltntnt. 

Tail indtx - Indtx of laat frtt tltntnt. 

In utt - Curnnt nunbtr not in frtt litt. 

DvtrfloMl • Nunbtr of nqutttt neda for an tltntnt. 

Total nqueitt - Total nunbtr of tltntnt. nqutit.d. 
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Ttblt Eltnant Allocation (SIUF) 



Tht allocation of tht tlintntt in thi 100 timinal bufftr (TBUF) and 
lyittn bufftr (SWF) tablt. it of eoneim to tht I/O tytttn. 

FREE LIST OF TABLE ELEIKNTS 

Thtit tabltt an in tN fom of a fnt-linktd lilt of thi frtt ilmtnti. 
For tht SBUF'i tht -1 uord of entry it tht link to tht ntxt tltntnt. 
For tht TBUF't, uord nro it tht link and uord 1 ii tht link for tht 
100 tltntnt.. 

Each uord hat an 11-uord htadtr beginning at tht ban of thi tablt . Tht 
firtt tin uord. of tht htadtr art for nanaging thi tabla and tht ncond 
flvt art for nonitoring tablt activity. 

Tht tntriit follou tht htadtr at uord tlivtn. 



ELEMENT ALLOCATION 

Eltntnti an obtaintd fron tht beginning of tht fnt lilt, pointtd to 
by tN htad and ntumtd to tht end of tht fnt litt pointtd by tht till, 

Uhin tht fnt litt it tnpty, tht htad indtx it lire and thi till indtx 
it ttt to point at tht htad indtx. 

Tht tablt. trt divided into tuo ana.: a prinary and a stcondary int. 
Ik»t nquMti an obtaintd fron tht prinary ana. Tht aecondtry ana i. 
uttd only for critietl requirenent. uhtn tht prinary ana ie exhauited. 
Theet anat an logical ana. dttemimd by parantttn in tht htadtr. 

Tht utility of tht con ntidtnt table, it ttrioutly nduced if their 
utt it not rtttricttd to dynanic aituationt. 

Oni of thnt neponic. nu»t bt .pacified to tht reutint. xhich allocate 
elenente fron thi I/O tystan table*. 

1. Inpede caller if prinary i. tnpty. 

2. Get fron prinary ana only. 

3. Set fron itcondary ana if prinary ana it tnpty. 
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91 - 
63 
50 
49 
41 
47 
46 
45 
44 
43 
42 
41 
40 
39 
3t 
37 
36 



ICS Olobtl 



RESERVED 



CANOPIN 
LASTUEIEHT 



PAUSETWE 



LISTSTATE 

CUREFILTEA 

CURDFILTER 

CUTMM 

CUTDEWn 



CURCFILTER 
NRXCFIITER 
MNCFIUER 
ESCHEDBASE 
DSCHEDBASE 



35 1 CSCHEDBASE 



I- 



34 | UORSTEPRI 
I 

33 1 UOASTDPRI 



I- 



32 1 UORSTCPRI 



I- 



31 1 DISC. BOUNDS FLAGS 



I- 



301 SVSTEM HEN SOUND 



I- 



29! NDS UPPER SOUND 



I- 



2SI DL INITIAL 
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KSlflrtlJi (Cent.) 



| 1 

271 I 

| 1 

261 XDS SEWEBT BANK I 
| j 

251 XDS SE5HENT BASE I 
| 1 

24| XDS SEBIENT LH1IT I 
| 1 

231 FKIV BNDS STHT UO I 
| 1 

22! I 

'. RESERVED '. 



19 




18 


DISflP 


17 


Reserved 


16 


SDST 


15 


PSTR 


14 


P8DDR 


13 


TRRCE FUffi 


12 


PFMl 


11 


:cut 


10 


XP 


9 


PCBX 


S 


Z 


7 


DL I 


6 


S I 


5 


SBRNK 
1 



Serin 64 only 
Scries 64 only 
Series 64 only 
Series 64 only 



PSEN, PS06 counter 



process' stick DSTtt 

pseudo-inttrrupt status 

pseudo-intirrupt address 

flag set non-zero on IXIT way fron ICS 

PTR to pouerfail PCB 

absolute JCUT address 

pointer to executing process PCB 

absolute stack address 

stack DB relative Z 

stack OB relative DL 

stack D8 relative S 

stack bank 
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ICS Global (Cont.) 



I/O 



CS 80 Disc Interrupt Linkage Table (ILT) 

There is one ILT for each device controller configured on the systen. fl con- 
troller nay support nor* than one unit, houever the CS'80 disc driver uill 
only concern itself with the single unit controller. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 fiKEflONIC 

+ __ + — 4.-4.— 4.— 4— 4 — 4 — +. — +__+__$ — 4 — 4—4 — ♦ — + 

0| Channel I ICPVflO 

1 1 Progran I ICPVR1 

2! Variable I ICPVR2 

3| Area (ICPVfl) I ICPVA3 

4 + 

4| NIA Abort I ICPVM 

5| Address I ICPVA5 

+ + 

6| I ISRUL 

+._*. ♦ » + + 

7 1 LI | CIMNQUE I I CHfiH | DEV | ICNTRL 

+ __+ + 4 ♦ + 

X10| SYSDB relative pointer to channel progran areaf ISIOP 
+ + 

2111 SYSDB relative pointer to idle status area I ISTflP 

4 + 

XI 2 1 single instruction that is executed to extractl IUNIT 
I the device unit nunber fron the status pointed I 
I to by ISTAP. [Since only Unit exists on the i 
I CS'80 discs, ANDI is used to return Unit 0] I 

+ — 4 

X13I SYSDB relative DIT pointer of the device I ICOP 

I currently using the channel to perforn * I 

I data operation. I 

+ + 4 

X14) SXOPSIZE I CQUEN I IOUEUE 

4— 4—4--+ ♦ + ♦ 

X1S|RU|UP|IG| I HCUHIT | IfLAD 

4—4—4—+ * * 

X16| SYSDB relative 017 pointer for unit I IDITPO 

+ + 

Z17i 20 bytes status area for idle channel progran I ISTRT 

4 4 

.1 • I 

t + 

•I . ■ i 

+ -4. 

X311 CS'80 Discs I 

Channel 
| Progran I 



ICPVRO - Channel Progran Variable Urea 



4 




STDB 


3 





2 


P 


1 


STRTUS 





P 1 





*1 


D9 BANK RETURN 




DB RETURN 




1 


___ PflRfl 



absolute stack DB 



> DISPATCH stack narker 



> FOR DISPATCH 



P=PSEUDQ-DISP8LED AND DISP INSTRUCTION EXECUTED. 
DISPATCHER INTERRUPTED. 



ICS Global Cells Hith Initial Values 



STDB - absolute address of the currently running process's stack. 
SBRNK - bank address for process' stack. 
S - stack DB relatives 
DL - stack DB relative DL 
Z - stack DB relative Z 
PCBX - absolute stack address 

XP - PCB table relative pointer to word of the running process' 
PCB. 

The above cells are to be initialized for the PROGENITOR. 



CPCB - absolute 4, is an absolute version of XP. If CPCB is zero, 
then the above cells are invalid. This uill never be the 
case in a process. CPCB should also be set by INITIAL. 

SDST - DSTO for running process' stack. 

JCUT - the bank zero absolute address of the JCUT table. 

PADOR - PB relative address for the procedure PSEUDOINT. 

PSTfl - status value for PSEUDOINT, Z14O0O0+CST*. 

DISRP - PSDB counter, initially 0. 

INITIAL sets the above as described. 
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The first word is used by the channel progran processor to store status in- 
formation after I/O channel aborts. The next word is used by the driver to 
indicate if status should be exanined for special conditions or errors. The 
other tuo Mords are not used. 



ICPVR4 - DF1A abort address 

If a SUA abort occurs, the absolute address uhere the abort occurred is 
stored in this area. 



ICNTRL - Contains controller information 

Lid -If this bit is set, the controller is sharing a software channel 
resource in order to linit bandwidth. 

CHANQUE -The software channel resource nunber. 

CHAN -Channel nunber (four nost significant bits of DRTN). 

DEV -Device nunber (three least significant bits of DRTN). 

IQUEUE - The channel progran contains; 

SIOPSIZE - (nunber of words + 1)/2 in the channel progran area. 

CQUEN - or a nuiti-unit controller this field contains the 
software controller resource nunber. 

IFLRG - Controller and Channel Progran state flags 

RUNURIT - An Idle Channel Progran should be started uhen there are no active 
requests to process. 

UfllTPROG - Rn Idle Channel Progran has been started for this controller. 
This bit is reset by an interrupt. 

IGNOREHI - An HIOP instruction has been issued against this controller but 
the channel progran was not in a uait statenent. Therefore ignore 
the interrupt generated by 

HCUNIT the channel code uhen this progran halts. - Highest configured unit 
nunber for this controller. 

ISTHT - 20 bytes of status fron the idle channel progran. 
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CHAPTER 14 SPOOLING 

Input Device Directory/Output Device Directory 
IDD/ODD (Connon attributes referred to as XDD) 



IDD: DST = 45 (= Z55) 
SIR = 3 



Overview of Table Structure 



+ 

I Entry (8 uords) 

■ I 

2 | Subentry tna pointer 

• I 

7 I 



DUD: DST = 46 (= Z56) 
SIR = 4 



I I 



I I 

-♦ I 

I I 

I I 

I I 



I 

I Head entries (4 uords each) 

I 



I I <- 

| Subentries (Z40 words each) | 

I I 
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Entry [Overall Table Defin itio n s} 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 
+--M--I--I--I--I--IHHH--I--I--IH--I"* 

0| Flaxinun size j Current size |0 (sectors) 
* *. + 

1| Head entry size = 4 | Subentry size =140 |1 ( uords ) 
t + + 

2| Subentry area pointer (segnent relative) 12 
+ __ + + 

3|DDj Next avail device file ID (DFID) |3 
4I///////////////////////////////////I Fence j4 
S1///////////////////////////////////////////////I5 
6I///////////////////////////////////////////////I6 
7I///////////////////////////////////////////////I7 



DO: ==> This is the IDD, 
1 ==> This is the ODD. 

Fence: For spooled output devices (ODD), the systert-uide out- 
fence. For spooled input devices (IDD), the jobfence. 
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Typical Head Entry (4 Hords) 



1 2 3 4 S 6 7 8 S 10 11 12 13 14 15 
4 __|__|__ MH .-|-|-|-|_-|„|-_|-|-|--|"* 
I Device outfence | /////////////////////// I 



Spooling 

Typical Subentry fZ40 uords) 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



-I-I-I-I--I-I--I-I--I-I-I- 



-i-i- 



Head pointer 



XO|//|State| Outpri |CL| /////////////////////// 10 
+—+—+—+ +--* + 

XI I Type I Job nunber |1 



Tail pointer 



Logical device 



There are two types of head entry, a class entry and a logical device entry. 
There is only one class entry, and it is the first head entry in the ODD. 
The IDD does not have a class entry, and its position is filled Mith zeros. 
Hll spoolfiles opened by class (e.g., LP, SLQULP, EPOC, PP, etc.) are linked 
to this entry. There is one logical device entry for each real (physical, as 
opposed to virtual) device on the systert. Output devices appear in the ODD, 
input devices in the IDD. RC/DC devices such as teminals appear in both 
directories. 

Each head entry is linked to or nore subentries (a typical subentry is 
shown in the next table). R null chain (0 subentries) consists of head 
pointer = and tail pointer = segnent-relative address of the associated 
head pointer. If one or nore subentries exists, the pointers are segnent- 
relative addresses of the first word of the first and last subentries of the 
chain. Rny internadiate subentries are linked through the subentries. The 
tail subentry always contains a 0-iink. 

The Device Outfence and LDEVH fields are neaningless for the class entry. 
For logical device entries (non-0 Logical Device field), a non-0 Device 
Outfence neans that this outfence overrides the systen-tiide outfence in uord 
4 of entry 0, but only for this device. 




Z12| 
Z13I 

Z14| 
Z15| 

216| 

Z17| 
Z20I 
221 1 



no 
m 

112 
113 
-* 
|14 
115 
116 
117 



%2Z|I0| Device file ID MS 

+ — + — + — * ♦ 

Z23|FS|Dfl|//l XDD head index (see explanation) |19 



Z24| Logical device, or Device Class Table index |20 



Z25| Virtual LDEV nunber of open spoolfile 



Z26| Volune table index I Sector address. 



121 
-* 
1 22 
I 
of spoolfile label. 1 23 



Z30| Nunber of extents I tllllltllllllllllllllll 1 24 



Z27I 



1311 



Z32 1 SO ! // 1 RS 1 FD I SO I flB I // 1 



Last extent size (sectors) 



Nunber of copies 



125 

126 
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X33I Segnent-relative link to next subentry, |27 
I this device or class. ==> last subentry. I 
* + 

Z34[ Nunber of records in spoolfile (doubleuord) 128 
1351 129 



Z36I 



Year IH» 100 



I Julian Day of Year/2 1 30 



Z37|DY| Hour (24 hr) | Binute 



I Seconds/4 |31 
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Uordt 0-J24 in into 1 in ill tubintritt, Uordi K25-X37, 
although promt in ill lubtntrin, in »po unltti tht 
tubentry it Per a spooled fill (tpoolfilt). 



Uord 0: Statt 



Uord 1: Typt 



Uord 111: 


10 


Uord X23: 


FS 




m 




Head 

index 



Uord Z24: 

Uord Z25 VOEV 



UordKf: 


VTMX 


Uord 232: 


SO 




US 




n 




so 


RB 
Uordi 136-37: 



- State of lubintry: 

■■> Active 

1 ••> Rudy 

2 ■•> Opm 

3 >■> Lockfd 

■- 1 •«> Uord X24 i> i elm indtx into thi 
Divice Clan TebXi. 
••> Uord X24 ii thi LDEV mguittd Kith 
thil tubentry. 
•- Dtscribtl utiicti enviroment crtlttd tht 
tubentry: 

■■> Sttlion' (SPOOK) 

1 •■> Seeaion 

2 ■•> Job 

3 ■•> Job' (SPOOK) 
•- 1 «> Output OFIO 

■■> Input DFIO 
•- Than an out or nore form nettagc re- 
qutfta in tha ipoolfili. 

- Tht ipoolfili um created via a :00TB raeord 
(input f pooling only). 

- Tha (ttgwnt-nlatlve addnii)/4 of tha 
haad entry with which thil tubentry ii 
linked. Sinca head mtrits »n four uordt 
long, thia can bi thought of H an index 
into tha head tntry portion of the X0O--if 
you ditallou valuta of and 1. 

- See deacription of Uord 0. 

- LP0T index of virtual device LDEV. Sinu- 
latei thi proptrtiet of a real LDEV to tha 
proeeti uhich FOPEKa a neu (previoualy 
non-txitting) file (State field (XDO(O). 
(1:2)) ■ 2 (Open)). 

- The volute table index of the logical de- 
vice in clan SPOOL uhen the file label 
(firtt extent) of thi apooifiie livti. 

- 1 ■•> Squeeze (purge) apooifiie extent! aa 

the final copy ii printed. Obaolate 
eterting uith COO. 20. 
•■> Purge only Hhen final copy printed. 

- 1 ■■> Rattan job uhen uamatarting (input 

•pooling only). 

- 1 *■> There ere non-standard fome on the 

device. 

- Spaced Out bit. File Syatan could not ac- 
quire a ntM extent Hhen creating apoofilt. 

- Thil ii the IST0LIST of an aborted job. 

• Tine etanp uhen epoofile uae nade READY, or 
OD if not cloaed properly. Julian day ii 
9 bita eterting uith Uord X36, bit S. 
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nil other uordi an zero. 



File Directory 

The File Directory hat one entry for each tpoolfile on the tape. Each entry 
ie 12 uordt, and entriea are packed into at nany 1020 uord recorde at needed. 
The latt record Hill be padded uith zeroe if neceitary. The entry fomat it: 

Uord 0: Device file id nunber (bit ie on to indicate 

that the file it an output apooifiie) 

Uordi 1-3: zero 

Uordt 4-7: Uier nane 

Uordt S-1 1 : Recount Nane 

Device and Clatt Directory 

The Device and Clata Directory it contained in one 1024-uord record. There 
it no EDF separating thit record fron the File Directory. Thit directory 
contain! one entry for each logical device or device clatt linked to the 
tpoolfilce on the tape. Blso, there it an entry for each logical device in 
each date in the directory, uhether or not that logical device uat directly 
referenced by a apooifiie. The entriet are packed into the tape record ons 
after another in no particular order. The entry fomatt are thoHn belou. 

logical Device Entry 
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ffWH Thi f,m» 



Thi ovirill fomat or output teste produced by the SPOOK "OUTPUT' eotmand ie 
ehoun belou. Tht viriout conponentt of the tape are then described in 
datail. The fomat deicribtd hen it lubjtet to change ai APE avolvti. 
Alio, than nay bt irrort in SPOOK uhieh uould cautt thi ictual tept fomat 
to differ fron tht one dttcribtd hen in loni can, fill nuniric infomation 
it in integtr fomat unltti othtruiH tpeeified. 



EOF 

EOF 

Label Record 

EOF 

File Directory Recorde 

Device and Cltaa Directory Record 

EOF 

Spoolfile 

EOF 

Spoolfile 

EOF 



Btchaniant for End-of-tape end tape tuitching an the 
STORE/RESTORE tepee. 



label Record 

Uorde 0-13: "SPOOLFILETRPE LRBEL-HP3000." 

Uord 23: reel nunber (fint reel ie nunber 1) 

Uord 24: dete (fron CALENDAR intrinaie) 

Uorda 25826: tine (fron CLOCK intrinsic) 

Uordi 30*31: "NPEV" if an HPE V SPOOK tape 

0.01.00 
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at for 



Herd 0: 
Uord 1: 



logical device nunber 



Bite 0:8 
Bite 8:8 



device tubtype 

3 (=length of thit entry in worda) 



Uord 2: device type 
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Device Claea Entry 



Uord 0: Device claat nunber (negated). Thit it the nunbtr 
of the entry of thie device claat in the eyaten'a 
Device Clatt Table. 

Uord 1: Total nunber of uorde in thit entry. 

Uordt 2 on: Tht entire content! of tht Device Claaa Table entry 
for thit device claea. 



Spoolfile Fomat 



ODD entry (32-word tape record) 



Spoolfile block 
Spoolfile block 



— > Tuo spoolfile block! packed into one 
1024-uord tape record. 



Tuo apooifiie blockt 
Tuo tpoolfile blockt 



The firtt feu ipoolfili blockt have been nodified to contain uttr label in- 
fomation fron the ipoolfili. Thie ie explained later. 



Spoolfile Block Fomat 



fl tpoolfile block it a 512-uord block that contain! variable length record! 
in spooler fomat. Spoolfile records ttart at the first uord of the block. 
The last record is followed by a -1 to indicate that no nore records follOM. 
The last tuo uordt of the block contain a doubleuord uhich is the record nun- 
ber of the first record in the block. 



Spoolfile Record Fomat 

Uord 0: Byte count of record - 2 



Byte count of data portion of record. Note 
that this count includes trailing blanks. 
Houever, trailing blanks *n truncated in 

5.01.00 
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Spooling 



the actual record, so this count nay be 
nan than the nuriber of bytes actually 
present in the data portion. 



word 


2: 


Function Code: 1=Furite 
2=F control 
3=Fopen 
4=Fclose 
HOC and beyond=FDEVICICONTROl 


Uord 


3: 


P1 — flTTRCHIO paraneter 


Uord 


4: 


P2 -- flTTRCHIO paraneter 


Uords 5 on: 


Data Portion of Record 


User Labels Information 



Spoolfile« have a nunber of user labels uith several kinds of information. 
These are: 

1 . Raster: user label 0. 

2. FOPEN entry catalog: user labels 1-10. 

3. Circular queue for restart checkpointing: user labels 
11-27. 

Since older versions of tlPE did not use user labels, a uay uas needed to in- 
corporate then into the SPOOK tape fontat uithout losing forward and backuard 
compatibility. The Method used is to add several special spoolfile blocks to 
the beginning of the spoolfile on tape. Each of these blocks has exactly one 
FOPEN record at its beginning. This record is folloued by a -1. Thus old 
versions of APE uill assune that the rest of the block is garbage. However, 
the rest of the block is actually used to contain user label information. 
The first tuo spoolfile blocks (i.e. the first tape record of the spoolfile 
proper) contain only the FOPEN records. The next 5 tape records actually 
contain user labels in addition to the FOPEN records. The user labels are 
packed 3 to a spoolfile block, 6 to a tape record. Each spoolfile block of 
512 words has the following foraat: 

Uords 0-4: FOPEN record 

Uord 5: -1 (to "terminate" the block) 

Uords %200-Z3?7: user label 

Uords Z40O-H77: user label 

Uords Z600-Z777: user label 
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Spooling 

Following this special group of blocks, the spoolfile resume a normal for- 
nat. The special FOPEN records all have the nunber of user labels in P2. 

It is often the case that sons of the 27 user labels have not been initial- 
ised before the tape is written. In that case, their places will be filled 
with garbage. There is no easy uay of detecting this except by careful 
inspection. 
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CHAPTER 15 UNIFIED COJ1BBHD LANGUAGE (UNCI) 



Reply Infornation Table (BIT) 

DST Z34; SIR 125 



MlltlBER OF ENTRIES 



I| 

01 
.flag=10 

11 
| 

21 POSITION OF NEXT FREE ENTRY SPRCE IN QUEUE 
| 

31 
I- 



BAX NUB8ER OF ENTRIES 



NUNBER OF QUEUED ENTRIES 



I (52 UORDS TO HOLD PINN's OF QUEUED ENTRIES) 
| 



I 



UNUSED 



PROCESS NUNBER (PIN) 



OSW (FOR REPLY) 



BUFFER ADDRESS (DST RELATIVE) 



3| BAX LENGTH OF STRING I REPLY TYPE EXPECTED 
| 

41 



El 
.flag=1 



• BYTES IN BESSAGE 



.flag=1 



BESSAGE IN ASCII 
(UP TO 86 CHARS.) 



I 

I 

I TABLE 57 

i HERDER ud 

I 

i 

! 

I 

I 

/ 

\ 

I 

I 

I 

I 

i 

I 

I 

I 

I 

I 

I 

I ENTRY 

I (51 

I uds) 



NOTE: Process Nunber = Means entry is enpty 
Reply Type ~ for nunber (nun) 

- 1 for yes or no (y/n) 

= 2 for string (sxx) 

= 3 for yes, no, or STRING 
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Bessaqs Catalog 



Bessages in the catalog can be of any length and can contain up 
to five paraneters. Continuation of a nessage is indicated by 
"X" or "4" at the end of a line. The "X" synbol indicates that 
the nessage is continued and that a carriage return, line feed be 
issued the teminal. The "&" synbol indicates that the nessage 
is continued on the sane line with no carriage return, line feed. 

Paraneters nay be inserted into the nessage fetched fron the 
catalog. The paraneters are passed in the GEHBESSAGE (or GENflSG) 
call and inserted uherever a "!" is found. For the systen nessage 
catalog, the back slash (\) is also a paraneter, reflecting a 
logical device nunber. The nessage is routed to the user associated 
uith that logical device through the :ASSOCIATE connand. Message sets 
are indicated by "$SET n" starting in colunn 1 (the rest of the line 
is treated as a cement). Haxinun value for n is 63. Corwents 
can be inserted in the catalog by placing "J" in colunn 1 . 
Ilessage nunbers are positive integers, need not be contiguous, 
but nust be in ascending order. After processing by the progran 
nRKECBT, the catalog file contains records of 80 bytes, blocked 
16, in 32 extents. (The systen nessage catalog is only one 
extent, houever). The fornat of the nessage catalog is as 
follows: 



$SET 1 SYSTEB BESSAGES 

1 LDEV t! IN USE BY FILE SYSTEB 

2 LBtv #! IN USE BY DIAGNOSTICS 

3 LDEV IN USE, DOUN PENDING 
5 IS "!" ON LOEV»! (Y/N)' 



J BESSRGE 35 IS TUO LINES LONG, A PARABETER STARTS THE 
I FIRST LINE AND THE SECOND LINE IS "HP320O2" 
35 \X 
HP32O02B.O0.! 



276 LDEV « FOR "!" ON ! (NUH)! 

t 

(SET 2 CIERROR BESSAGES 

82 STREAB FACILITY NOT ENABLED: SEE OPERATOR. (CIERR 82) 

2C0 BORE THRN 30 PARABETERS TO BUILD COBBAND. (CIERR 200) 



204 FILE COBBANO REQUIRES AT LEAST TUO PARABETERS, INCLUDING 
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.flag-2 

* 4 for string 
TABLE SIZE - 2046 uords 

.flag=2 
IfflX » OF ACTIVE ENTRIES = 39 
HAX * OF QUEUED ENTRIES = 52 



Bessaqe Svsten General Description 



The nessage systen consists of the following parts: 

- Callable intrinsic GENNESSAGE. 

- Uncaliable procedure GENBSG which is used by BPE. 

- Systen Message catalog (CATALOG. PUB. SYS) and any nunber of 
user catalogs. 

- Progran BAKECAT which builds nessage catalogs. 

- BESSAGE SIR 124 

- "ESSRGE SYSGLOB CELLS Z371-373 

- BESSAGE OATA SEGBENT 

The nessage systen is used by calling GENBESSAGE (or GENBSG) uith 
a nessage nunber. The nessage systen fetches the nessage fron a 
nessage catalog, inserts paraneters, then routes the nessage to a 
file or returns the Message in a buffer to the caller. 

R nessage catalog is a nunbered editor-type file containing sets 
of Messages. The sets serve to break a catalog into nanageable 
portions. A nessage systen user nay call GEHBESSAGE using either 
his own nessage catalog or using BPE's catalog (CRTRLOG.PUB.SYS). 

After creating a nessage file, run the progran BAKECAT in order 
to build a catalog that is readable by the nessage systen. This 
file is still readable by the editor (it can be "texted") but it 
contains a directory (written as a userlabel). 

In order to use the nessage catalog, the progran nust first open 
the nessage catalog, then call GENBESSAGE uith the file nunber, 
set nunber and nessage nunber. (HPE users don't need to open the 
catalog, GENBSG autonatically uses CATALOG.PUB.SYS.) The file 
nust be opened uith the aoptions "NOBUF" and "BULTI" -record 
access. 
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THE 
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FORflAL NRBE OF THE FILE (CIERR 204) 



BAKECAT Progran 



The progran BAKECAT. PUB. SYS is used to build nessage catalogs 
(and also HELP catalogs). The progran's input file has the 
fomaldesignator INPUT, which nust be used for all entry points. 
The progran has the following entry points: 

(no entry - Reads fron input file and builds a tenporary file 
point) (fomaldesignator CATALOG). Also renanes any old 
tenporary CATALOG, CATnn, using an archival 
nunbering schene (i.e., CAT1, CAT2, etc.). 

BUILD - (Bust log on under BANBGER. SYS. ) Reads fron input 
file, build the systen nessage catalog 
(fomaldesignator CATALOG), and installs the 
nessage systen. Existing catalog is renaned 
CATnnnn according to the sane schene as for no 
entry point (above). Installation of the Message 
systen neans noving the directory contained in 
the userlabel of the catalog into a data segnent. 
The DST nunber and the disc address of CATALOG 
are placed in systen global area. The nessage 
systen nay be installed while the systen is 
running. 

DIR - (Bust have PB or OP capability.) Installs the 

systen nessage catalog (does not build a neu 
one). Opens input file, noves the directory in 
the CATALOG into a data segnent, and places the 
DST nunber and disc address of CATALOG in systen 
global area. This nay be done when the nessage 
systen seens to be "broken", but the catalog is 
intact. (BPE is issuing "BISSING BSC-. SET=nn. 
HSG*nn" at teminals and at the console.) This 
nay be done while the systen is running. 

HELP - Used to build the HELP catalog. Reads input file 

and builds a HELP catalog (fomaldesignator 
HELPCAT). 
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1ST 1 

•SIT 2 
•SET 3 
•SET 4 
•SET 5 
(SET « 
ISET 7 
•SET I 
ISET 9 
•SET 10 
ISET 11 
WET 18 
ISET 13 
•SET 14 
•SET 15 
•SET 16 
•SET 17 
•SET 1! 
•SET 19 
•SET 20 
•SET 21 
•SET 22 
•SET 25 
•SET 26 
•SET 27 



■ Syatan ntaaagta, 

• CI trrora and uaminga ntaaagta. 

■ fliactUantoga (SORT htiutii. 

- Progrtii trror aoort ntaaagta. 

■ Intrinaiea abort naatagta. 

■ Run-tint abort nttaagaa, 

■ CI gtntral nataagtl. 

■ Fill Syatan trror netugaa. 
' Loadtr trror ntaaagta. 

• CRENTE trror ntaaagta, 

■ RCTIVSTE trror ntaaagta, 

■ SUSPEND arror Mtlljn. 

• HYCOnflHND trror ntaaagea. 

• LOCKOLDRIN trror ntaaagta, 

• Privatt Volunea trror ntaaagta. 

- OS/3000 ntaaagaa. 

• HELP facility trror nasaagaa. 

■ Graphic dtvicta ntatagea. 

■ Strial OiK trror ntttagaa. 

' Uttr Logging trror ntaaagta. 

■ fleaociation Utility (RSCCTRBL) ntaaagta. 

■ 2680R Pagt Printtr nttsagtt. 

■ 2680R Pagt Printtr trror file ntaaagta. 

■ Ditc Fret Spact ntaaagta, 

' Sytten Inttmal Error ntaaagta. 
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HEM> Sytfymn 



KEPT BS USER LABEL 

read onto usee's strck 

USES SEARCH INTRINSIC F0RHBT 
VARIABLE ENTRY SIZE 



Ol 
I- 



DIRECTORY SIZE (IBROS) 



II ENTRY LOTH (BYTES) I KEYUORO LOTH (BYTES) 



21 



ENTRY 
KEYUORO 



ENTRY RECORD » IN CICRT 
If FT BYTE | RIGHT BYTE 



ENTRY LGTH (BYTES) I KEYUORO LOTH (BYTES) 



ENTRY 
KEYUORO 

1-2SS BYTES 
I- 



\ 
I 
I 
I ENTRY 

I 



I ENTRY REC t LEFT BYTE 



IENTRY REC I R. BYTE I ENTRY LOTH (BYTES) 

IKEYUORO LOTH (BYTES) I 
I 

I ENTRY 

KEYUORO 
1-255 BYTES 



l\ 



I ENTRY REC • 

I LEFT BYTE I RIGHT BYTE 



I / 
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8mm in WficWfy 

OST « IN SYSOLOB 1373 

CRT OISC ROW IN SYSOLOB 1371-372 

CRERTEO BY RUNNING HBKECflT.PUB.SYS. 

KEPT IN R DRTA SE6HENT RNO IH « USER LABEL. 



ORTR SEGflEHT 



NRX, SET* 


• of mssfloe records 


RECORD OFFSET TO FIRST NESSS6E 


FIRST P.ESSA6E « 


RECORD, OFFSET TO FIRST NESSASE 


FIRST MESSAGE » 



HERDER 



I 

0\ 
1 / 



2\ 

I SET 1 
3/ 

4\ 

I SET 2 
5/ 



ENPTY ENTRY 

I 
-I 

|40\ 
-I I SET 63 

141/ 
-I 

|42\ 
-I I CUR riSG 

143/ 
-I i 

144 

(640 UORDS) 



I 



50 
51 




RECORD OFFSET TO FIRST BESSRGE 


FIRST NESSRCE » 


52 





53 


RECORD OFFSET TO CURRENT HESSBGE 


54 


I1ESSR0E 
BUFFER 



USER 
LABEL 



1253 
EOPTY ENTRY: 



1 

RECORD OFFSET OF NEXT IH-USE SET I 
1 

-1 I 
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UOC Directory 



•EXTW1 DATA SCGflENT - OST » IN DB*MS5 OF UNRIN STRCK 
•BUILT BY INITUDC 



12 3 



6 7 S 



I- 

ILT|LH|HH|NBI |TY I ENTRY SIZE 

I 



HERDER RECORD NUNBER 



BODY RECORD NUHBER 



I FILE NUWER | COnMND LENGTH 
| 



I 



COrMND 
(1-16 BYTES) 



\ LT-OPTION LIST 
I LN-OPTION LOGON 
NH-OPTION NOHELP 
NB-OPTION NOBRERK 
TY- 00=USER UDC 
01 'ACCOUNT UDC 
10'SYSTEN UDC 

ENTRY 



ENTRIES 



LAST COfflRND ENTRY 



| 1 

I LAST ENTRY (12 uorda OF itrot (0)) I 



I ENTRY SIZE-* ENDS DIRECTORY 
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iiDCs connaKD.PU8.svs 

*REC0RO SIZE = 20(10) UOROS, S REC0RDS/8L0CK 
*KEEPS TRUCK OF UHO IS USING IIHflT UDC CATALOG 
*CAN GE PURGED TO DISABLE UDC'S 
*CAN 8E REBUILT TO RE-ENABLE UDC'S 



RECORD 



| 

0|1st FREE ENTRY * 



nnx IN USE 
• IN USE 



I- 

1 1 not used 
| 

Zl 

I 
3| 

| 

4| 
i not used 



23! 



119 



Z FREE ENTRY * 
| 1 

| NEXT FREE ENTRY *I0 
| 1 

1| ENTRY TYPE=0 |1 



23| 



119 
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USER ENTRY * 

1 

CATALOG ENTRY # |0 
1 

ENTRY TYPE=1 |1 
1 

|2 
USER« | 

|3 

I 



COnnflND.PUB.SYS (Cont.) 



FILE ENTRY • 

-I 



2 



NEXT CAT. ENTRY HO 
1 

ENTRY TYPE = 2 |1 
I 



FILE NAnE 



12 
I 

|3 

FOPEN FORnBT: I 
|4 
I 



FILE 



ACCOUNT* 1 7 



16 
! I 

7| [/UJCKUORD] 17 



I 

101 GROUP 



111 

I- 
121 



131 

I 

141 



151 

I 

161 



171 

I 

201 



211 

I 

22| 



231 



19 111 

-I I 

no i2i 



o no 

i i i 

111 131 |11 

i i i 

|12 14| |12 

i | (UP TO 36 BYTES) | 

113 1SI |13 
! ! i 

114 16| |14 
i I I 

115 17| |15 
I I I 

116 20| |16 
i I I 

117 21| |17 
I I I 
MS 22| MS 
! I I 
119 23! 119 

-I I 1 



* IF THE USER FIELD AND THE ACCOUNT FIELD CONTAIN "9_ 
THIS INOICATES SYSTEn LEVEL UDC'S. 



IF ONLY THE USER FIELD CONTAINS 9 ANO 7 SPACES, THIS INDICATES 
ACCOUNT LEVEL UDC'S. 
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CI Stack Definition 



DB+ZO 




BC0MJ10GE (Byte Ptr. To Connand) 




DBt%1 


\ 


COnnAND WAGE 
(280 bytes) 


\ 


08+Z21 5 


\l 
l\ 


UNELENSTACK 
(30 uords) 




DB«253 




NEXTUSS (Not currently used) 




D8«254 




THIS IS SPARE 




DB»Z255 




UDCO 




DB*X256 




UDC1 




D6+H57 




UDC2 




DB*Z260 




UDC3 




0B*Z261 




UDC4 




DB+Z262 




IFNESTING 




0B*Z263 




IFSKIP 




DB»Z264 




ELSESEEN 




0B*Z265 




CIFLAGS 




DB*Z266 




CONTINUE STATE STACK 
(2 uords) 




DB*Z270 




PENDINGCOHLEN 




DB+Z271 




BLASTCOnlnOGE (Byte Ptr.) 




DB+Z272 


\l 

l\ 


LAST COntlRNt) MAGE 
(280 bytes) 


\ 



Unified Connand Language 

Field Definitions 

BCOnlflAGE: Byte pointer to COnmAK (sonetines called UCOflllWGE) 
in the CI stack. 

CUffllRND WAGE: Connand character string currently being executed. 

UNELENSTACK: A CI connand can span up to 30 input lines. This 
stack holds the length of each input line. 

NEXTHSG: Used to be used to link nessages together. No longer being used. 

THIS IS SPARE: Not used. 

UDCO: Holds the DST nunber of the UDC definitions. 

UDC1: Holds the old S register value for UOC's. 

(0:1)-FUISHUDC, used by :SETCATALOG 



UDC2: 
UDC3: 
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(0:1) --OPTION LIST = 1 
(1:1)— OPTION LOGON = 1 
(2:1)— OPTION NOHELP = 1 
(3:1) -OPTION NOBREBK = 1 

UDC4: (0:1 J-UDC Fatal Ci Error 
(1:1)— UDC EXITBREAK 
(2:1)— UDC BREBKDETECTED 
(3:1 ) — UOC 'NOPRInT 
(4:1)— UDC IJ1HGEA0JUST 
(10:6)-U0C NESTLEVEL 

IFNESTING: Level of nesting of :IF connands. 

IFSKIP: Uhether the current connands Arz being skipped as the 
false part of a :IF connand. 

ELSESEEN: Level of the :ELSE connands. 

CIFLAGS: (13:1)— Sequenced: line nunbers at rear. 
(15:1 )— Not REDOable (last connand). 

CONTINUE STATE STACK: History of the CONTINUE connands. 
= 0— no CONTINUE 
- 1— just seen 
= 2— in effect. 

PENDINGCOHLEN: If <> 0, connand is already in stack and this uord is the 
Connand string length. 

BLASTCOWnfiGE: Byte pointer to last connand inage. 

LAST COIWAND WAGE: Uhen a connand conpletes execution, the connand string 
is copied here for use by the :REDO connand. 

G.01 .00 
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fHoaeiatlon DiT Layout 



Not 
Used 



JlfflT Index 








JIT OST Munber 


OST rcl. index to 


UMf'l 


nixt 


entry. 



Claw n«w undir uhieh this Idev it 
associated. Ltft justified and 
padded uith blanks. 8 bytes. 

3ES==SBXEXSX=XXXBKXXBXKXXS3KCXX3X2XX3XXi 







rmiiix:i":mii»f:»»l«::: 



Unified Conmnd Language 



DS7 M! 
SIR X30 



0« tntry/ 
tytttn ldtv 



Ldtv 1 
Associated) 



- Ldtv 2 
Unatsociated) 



JI1AT Index or 



JIT DST Nunber or 
Nixt Entry Pointtr or 



Clatsnane under uhich LOEV it 
aeoociated or undefined. 



?*n \ 
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Application rlaooaae facility 



Tht Application Metaagi Facility contiiti of tuo parts: GENCAT, thi cttalog 

naintanance facility, and tht "CUT" intrinsic!, through uhich tht ntttaga 
ettelogi art accetttd, Tht "conpiltd" catalog, uhich GCNtflT craattt, con- 
taint an txttmivt dirtctory at tht front of tht filt uhich dttcriett uhtrt 
tvtry nttsagt in tht catalog ia located. whtn t nettage catalog it optntd 
(via CflTOPEN) part of thi* dirtctory it rtad into an txtra data ttgntnt uhich 
it ertattd tptcifically for that purpoat. Thit "caching" of tht dirtctory 
provides ntarly dirtct acctta to tht deeired ntttagt. 

Thtlt ntttagtt include nettage tit nunbtr, ntttagt nunbert, and record nun- 
bert placed or "cached" into 384 word nettage cachet. The first act nunber 
and nettage nunber of each ntttagt cecht it placid into a cacht directory 
(act and nettage nunbert nutt be ascending), A netsagt it found by scanning 
first tht cache dirtctory, then the nettage cache ttarching for the detirtd 
eet and nessage nunbtr. The retrieved ntttagt directory entry contain! tht 
record nunbtr in tht catalog filt of that ntttagt. Hon, tht catalog filt can 
be read directly using the record nunber. 

Internally, tht tuo laytr directory fomat it uttd by both tht fomatted ap- 
plication nettage catalog, and tht ntttagt extra data atgnent created by the 
intrinsic CATOPEN (and uttd by CATREAO). 

Tht catalog filet created for flRKECRT and GENCRT nay be used uith tht 
Application ntttagt Facility. In nost catet, applicationt uill increatt 
their performance in ntttagt routing and decrease the file space uith fomat- 
ted catalogs. 



NLS flessaqe Cataloq/DST Overvieu 



| 1 

CACHE DIRECTORY 
| 1 

I I I 
1 | | 

I 
I— V 1 

RESSROE DIRECTORIES 
I I 

I I I 

I 1 I I 1 

I I I 



i 1 

i i i 
i — i i i — i 
i i i 



1 

i 

I- — v--— I 

I I 

I— I 

I I I 

I — I I I — I 

I I I 



l-v 1 

I DATR I DRTR I DRTR I DATA I DATR I DATA I DATA | DATA I DATA I 
I I 

The naxinun catalog sin is 65536 lectori long. Tht largest ttt nunbtr ia 
255. Tht largest ntttagt nunbtr it (4766, uhill the tnallttt ttt and ntttagt 

nunbtr it 1. 
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Fomatted Catalog File Structure 
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Cache Directory 



RECK 
REM 1 



OVERHEAD 



CACHE DIRECTOR* 



HESSAGE CACHES 



Each entry in the cache directory it a tuo uord entry. There exittt ont 
cache directory entry for each 384-uord nettage cacht. The first uord of the 
cache directory entry is the set nunber of the first entry in the associated 
nessage cache. The second uord of the cache directory entry is the nessage 
nunber of the first entry in the associated nessage cache. 



| 

! 1st set nunber of cache 1 



I- 

I let nsg nunber of cache 1 



I- 

I 1st set nunber of cache 2 



I- 

I 1st nsg nunbtr of cache 2 

I 



l-CRCHE DIRECTORY ENTRY 1 



<-! 



I-CRCHE DIRECTORY ENTRY 2 



<-| 



uhere HC ■ 2 ♦ (2 * ttnessage caches )/128 
D ■ HC ♦ (384 * Unessage caches 1/128 

Each physical record is one sector long (128 words). Each structure starts on 
a sector boundary. 



i 1st tit nunber of cache N 
I- 



i Itt nsg nunber of cache N 



-CACHE DIRECTORY ENTRY N 
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Unified Connand Language 



Message Cache Fortiat 



Each nessage cache is 384 words long (3 records). R nessage cache entry is 3 
words long, 128 entries per nessage cache. Each entry contains the nessage 
nutiber and set nunber of the nessage. The byte offset is the offset to the 
start of the nessage in the record specified by the record nunber. Entry 127 
is a duplicate of the first entry in the next cache. This is to allow the 
total nunber of bytes of the nessage to be conputed Hithout reading the next 
nessage cache. 



Nessage Nunber 


Set Nunber | Byte Offset | 


Record Nunber I 


.. 


dessage Nunber 


Set Nunber ! 8yte Offset I 


Record Nunber | 


I 


nessage Nunber j 
Set Nunber | Byte Offset I 


Record Nunber j 


= i 


nessage Nunber j 


Set Nunber | Byte Offset | 


Record Nunber f 



I 

I -ENTRY 

I 



I -ENTRY 12! 



I 

I -ENTRY 

I 



I 

I -ENTRY 127 

I 
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Unified Connand Language 



The fornat of the nessages is straight foreuord. It contains only the text 
of the nessage. It contains no connent records, nessage nunbers or set nun- 
bers. Ril leading and trailing blanks are stripped fron the nessage. 



Hessane DST CflDSTi Structure 



An nessage extra data segnent is allocated during a CATOPEN. The data seg- 
nent nunber is kept by the application on the return fron CRTOPEN. The for- 
nat of the data segnent is sinilar of that of the formatted nessage catalog. 
The nain difference is the addition of a table to track resident caches in 
the DST, and the catalog data in not kept in the DST. 



Message DST Overview 



'" HOST RESIDENT CACHE AREA 



HDST OVERHEAD 



HDST CACHE DIRECTORY 



HOST RESIDENT MESSAGE 
CACHES 



I1DST' OVERHEAD 



HDST'RESIDENT'CACHE 



HDST'CBCHE'DIR 



NOTE: A resident cache is a nessage cache copied fron the fomatted catalog. 
Resident caches »n suapped in and out of the HOST and are used to detemine 
the record nunber of the desired set and nessage. 
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Unified Connand Language 



Hessaqe DST Overhead 






„„„ | „„,. | 


1 


»S» | T I 


2 


Size of RDST ( in uords ) j 


3 


Catalog File Nunber 


4 


Offset to Resident Cache j 


5 


Offset to Cache Directory I 


6 


Offset to Hsg directories j 


7 


Cache Directory Size (uds)j 


8 


dsg directory size (uds) j 


9 


flax nun of resident cache j 


10 


Recnun of first nsg dir. j 


11 


Reserved j 


iZ 


Reserved 1 



HDST'ID 

HDST'SIZE 

nDST'CAT'FHUB 

HOST' RESIDENT 'CACHE 

DOST' CACHE 'DIR 

IIDST'tlSG'MR 

tlDST'CMR'SIZE 

HDST'DIR'SIZE 

MDST'CBCHF'IM 

nDST'FIRSTDIR'RECNUn 



Unified Connand Language 

flessaqe DST Resident Cache Area 



The Resident Cache Area is a table of the nessage directory blocks currently 
stored in the HOST, together uith their index. They an held in order fron 
the nost recently accessed at the top to the and the oldest on the botton. 
The naxinun nunber of caches held in the HOST at any one tine is 
IICST'CBCHE'IIBX. 



CACHE « HOST RECENT ACCESS 



INDEX OF CACHE DIRECTORY 
HOST RECENT ACCESS CACHE 



HDST'RESIDENT'CACHE 
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Unifitd Conntnd Language 



W5T tltflt MrwttT 



Each tntry in the cacht directory it a two uord entry. Thtri tKiitl one 
cacht directory intry for tach 384 uord nttsage cache. Tht fir-it uard of tht 
cacht directory tntry it tht ttt nunber of tht firtt entry in tht titociated 
neottgs ctchl. Tht ttcond uord of tht ctcht directory tntry it tht nestagt 
nunbtr of the firtt tntry in tht attociittd ntttagt cacht. 



1st ttt nunber of cache 1 



lit nig nunbtr of cacht 1 
1st tat nunbtr of cacht 2 



1st ntg nunbtr of cacht 2 



Tit ttt nunbtr of cacht N 



lot ntg nunbtr of cacht H 



<-l 

I -CACHE DIRECTORY ENTRY 1 
<-| 

<-| 

I -CACHE DIRECTORY ENTRY 2 
<-l 



l-CRCHE DIRECTORY ENTRY N 



G-.01.00 
15- 21 



Unifitd Connand Language 



HDST ntttaat Cacht Fernet 



Each ntttagt cacht it 384 ugrdt long (3 records). B ntttagt cacht tntry it 3 

uordt long, 121 tntritt ptr ntttagt cacht. Each tntry contain! tht ntttagt 
nunbtr and ttt nunbtr of tht ntttagt. Tht bytt offttt It tht offttt to tht 

ttart of tht ntttagt in tht record iptcifitd by tht record nunbtr. Entry 127 
it a duplicate of tht first tntry in tht ntxt cacht. This is to allou tht 
total nunbtr of bytt* of tht ntttagt to bt conputtd uithout raiding tht mat 
ntttagt cacht. 



ntttagt Nunbtr 



Stt Nunbtr I Bytt Offttt 
Rtcord Nunbtr 



foliage Nunbtr 



Set Nunber | Eyte Offset 
Record Nunber 



Ifestage Nunber 



Set Nunber I Byte Offset 
Record Nunber 



I 

I -ENTRY © 

I 



I 

I -ENTRY 128 

I 



-CRCHE 1 



Ntstegt Nunbtr 

Stt Nunbtr I Bytt Offttt 

Rtcord Nunbtr 



I 

I -ENTRY 

I 



I 

I -ENTRY 127 

I 
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CHAPTER 16 SYSOWP/INITIAL 
COHFDATB File 
Record of COHFPflTH File (CTBBO) 






CHECKSUn OF CTBB 





1 


CURRENT VERSION OF CTAB 


1 


2 


STANDARD STACK SIZE 


2 


3 


CORESIZE III K UORDS 


3 


4 


TERMNAL SOUND PRIORITY 


4 


5 


NORnflL PRIORITY 


5 


6 


CPU BOUND PRIORITY 


6 


7 


• OF SECONDS TO LOG-ON 


7 


10 


LOG FILE RECORD SIZE (SECTORS) 


8 


11 


LOO FILE SIZE (RECORDS) 


9 



miiiiiiiiiiiiiinmiiiiiiiiiiiiiiiiiiiiiiiiiiiiw 



141 
15! 
161 

I 
171 

I- 



LOG BITS (ONLY 11 USED) 



«DEFINES UHAT IS BEING LOGGEO» 



111 
I 

112 
113 
114 
I 

115 
-I 



20| DEFRULT JOB/SESSION CPU TIM LMIT 116 

| 1 

. iiiminiiiiitiiiniiiituiiiiiiitiiiiiiiiiiii ■ 
. iiiiiiiiiiniiiniiiiiiiiiiiiiiiiimiiiiiiiiii ■ 
. iiiiitiiimiiiiimfiiiiitiiumiiiiiiiiiiiii ■ 



34 1 



1MKIHUI OPEN SPOOL FILES 



-I 
1 28 



-I 



35I///////////////////////////////////////////////I2S 



I- 



— I 



36i ISO 

I nnxinun * of spool files (kilo sectors) i 

37 1 131 



-I 



40|///////////////////////////////////////////////i32 
| 1 

41 | II SECTORS PER SPOOL EXTENT 133 

| 1 

6.01.09 
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CONFO ATfi (Cont.) 



361 

I- 
371 



40| 

I- 
411 



nnxinun code seghent size 



nflxmun » of code seghents/process 



nflxmun stack size (haxdrta) 



imanun extra data segment size 



33 



421 nnxinun it of extra data segments/process 134 
. tllllllllllllUlllllllllllllllllllllllllllillll . 
. ttlllllltlllllllllllllllllllttlllllllllllllltll ■ 

■ iiiiiiiiimimiimiiiitmiiiiiiiiiiiiiiiiii . 
i 1 

sol nflxmun « running sessions |40 



I- 

511 

I- 

521 

I- 
531 

I- 
541 

I- 
551 

I- 
561 



nRxmun * of running jobs 

» LOG PROCS 



-I 

141 



I42 

-I 
l« 



ii disc rehuest table entries 



II special reouest table entries 

ft PRIBflRY MESSAGE TABLE ENTRIES 



67 | » SUAP TABLE ENTRIES 
| 
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144 
-I 
145 



146 
-I 
147 



* SECONDARY BESSRGE TRBLE ENTRIES 148 



Sysdunp/Initial/Store 



Record 1 of COXFOHTR File (CTA8) 



|_-|..|.-|..|..|_|_|~|~|_|~|_|--l-l--|- 
0| * OF CST. ENTRIES 



i OF OST ENTRIES 



# OF PCB ENTRIES 



• OF 100 ENTRIES 



II OF TERMNRL BUFFERS 



» OF CST EXTENSION ENTRIES 



INTERRUPT COHTROL STACK SIZE (01 to Z1) 



II UCOP REOUEST OUEUE ENTRIES 



• BREAKPOINT ENTRIES 



• TRL ENTRIES 



141 

I- 
151 



II OF SYSTEn BUFFERS 



II OF CONCURRENT PROGS 



161 



LOADER SEGnENT SIZE 



12 
-I 
113 



114 



1 

. iiiiiiiiiitiiiiiiiiiniiiiiiiiiiiiiiiiiiiiuiii ■ 
.iiiiiiuiiiiiiiiiiiiiiiiiiiimiiiiiiiiitiiim . 
.lijiiiiiiiiiiiiiiiittiiiiiiiiiiiiiiiiiiiiiiim 



i- 



SIZE OF VIRTUAL nEIWRY 



2Si 



DIRECTORY SIZE (SECTORS) 



20 



.illllillliliilllllllllllllllllllltlltllllllllli . 
.Illltlllllllllllllllllllimililiilllllllltllll ■ 
■ illiillllillillllllllHllllllllllllllllllllllll . 
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INITIAL/PROGEN Connunication DST 

The INITIAL/PROGEN Connunication data segnent is used by Initial to pass in- 
fomation to PROGEH. This tegnent is only tenporary and not nenory resident. 



COnnDSTN = SYSGLOBEXT (Z122) 



DST (SYSGLOBEXT (Z122)) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 



POINTER TO THE START OF CTBBO 



/ 1 

| | 

|/ 1 POINTER TO THE START OF CTBB 

1 1 | 

|i I SYSTEn START-UP OPTION 

1 1 | 

i J i RECOVER LOST DISC SPACE PROGRAB 

1 1 | 

1 1 | RESERVED 

1 1 | ... 

\ — > | CTRBO ARRAY (Record of the CONFDATA file) 

| | -• 

\ — >| CTBB ARRAY (Record 1 of the CONFDBTA file) 
| 



OPT 
Recovery 



256 - Z400 

256 * CTABO size 



DESCRIPTIONS 

OPT 



Start-up option 

- Uamstart 

1 = Coolstart 

2 = Coldstart 

3 = Update 

4 = Reload 



Recovery - 1 If Recover Lost 
Disc Space 
s If Not Recover Lost 
Disc Space 

CTBB & CTRBO -See the descriptions 
of CONFDATA file in 
this chapter. 

The nicrocode uill store the CNTRL B connand into (01-11) equivalent to 
(ABS(5!-11) for the Series 37. 

CNTRL B = Start 

1 = Uarnstart 

2 = Coolstart 
Z10 = Load 

111 = Update 

Z12 = Coldstart 

113 * Reload 

Z14 = Neu 

Z20 = Dunp 

Starttype ■ BBS (A6S (5J-11) 
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Oefdtta Til.lt Lookup file 



Thit filt contain! the default infornation for HP-tupporttd device!. Thi» 
filt, DEFORTA.PUA.SYS, it availablt to Sytdunp and Inititl and tlininatet tht 
motility for looking up default infornation every tin a device it added to 
tht lytttn. Oetpite its runt, DEFOOTR.PUe.SVS in not only a filt, but a labia 
in tht Coldload Infomation Tablt. It it not tatily nodifitd. Therefore, it 
it rttomtndtd that tht filt bt ltft alont; if any titer it unhappy uith tht 
default!, thty can bt ovtrriddtn during tht Sytdunp or Initial dialogue*. 

Ptfdata Ta»lt Lookup Filt Header F.mat 



1 2 3 4 S 6 7 I 9 10 11 12 13 14 tS 
i — t — 1 — I — I — ■ — I — I — I — I — I — ■ — I — I — I — I — 

I CHECKSUH 



1 I 
I- 

2 I 
I- 

3 I 
I- 

4 I 



VERSION 



T0TP.L TMlf SIH III UORDS 



ENTRY SIZE (SET TO 1) 



• OF TMLE ENTRIES 



Ptfdata Tablt lookup Fill Entry Fnraat 

C 1 2 3 4 5 6 7 « 9 10 11 1? 13 14 15 



DEVICE RATE 



3| 

I 
4| 

I 
SI 

I 

ei 

I 

7I 
I- 
< I 
I- 



TOTBL DEVICE ENTRY SIZE (M MMDS) 



9 II OF DEVICE CLASSES FOR THIS DEVICE (SET TO 1) 



6.01 .CO 
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Sytdunp/Initial/Stort 



Ptfdata Tablt lookup Fill E ntry Fomtt (Cont.) 



II 27 

II 

\->» 

I 

I 

I 
I 
I 
I 
I 
i 
i 
I 
\— > 



\ — > 



TEMIHRl DESCRIPTOR FILE UK 



TOtTDtU DESCRIPTOR CROUP ME 



TEHIINRL DESCRIPTOR ACCOUNT MME 



OUTPUT DEVICE CLASS WK 



DEVICE CLRSS HARE 
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Sytdunp/Initial/Stort 



Ptfdata Tablt Lookup Filt Entry Fomtt fCont. ) 



/— 10 
/-11 

l-n 

13 
14 
15 
16 
17 
It 



DEVICE CLRSS NAnt LIST POINTER (ENTRV RELATIVE) 



TERfllNRL DESCR. FILE MME POINTER (ENTRY REl.) 



DEFfiULT OUTPUT OEV. OR POINTER TO DEVCLASS 



CS LOTX ENTRY POINTER (CURRENTLY SET TO 0) 



1 2 3 4 5 6 7 t » 10 11 12 13 14 15 

-I-I--I--I--I-I--I--I-I-I-I-I-I-I--I- 



RESERVED 



DEVICE 10 CODE 



RESERVED 



RESERVED 



DEVICE TYPE I SUBTYPE IJ I SI I| OISP.ST 



CHAN. I|CR|DS|S0|CL|M| RECORD UIDTH 



20 
21 
22 
23 
24 
25 
II 26 



DEFAULT TERIt. TYPE |AR| RESERVED 



TERN SPEED 



DRIVER MME 
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Sytdunp/Initial/Stort 



Overvicu 



DEVOBTB.PUB.SYS 









PRRAHETER RECORD 




DRIVER TABLE 
LPDT 




IDT 




LDTX 




CLASS/TERN HEADER 




CLASS 




TERflDEF 




ADD'l DVR TABLE 




CSOEf 




CS TABLE 


Parameter fit 


ford 





CHECKSUN 


1 


VERSION 


2 


NEXT RECORD 


3 


HI6HEST LDEV 


4 


HIGHEST DRT 


5 


m. ADD'L DRIVERS 



6.01.00 
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(ENTRY RELATIVE) 



J*Job Accepting 
ft°0ata Accepting 
^Interactive 
D*DupIicativt 
SpP. ST. 'Spool Statt 

CR<ore Rttidtnt 
DS*OS Dtvict 
S0«Spool Oututt 
CL'Indicatet 

uhtthtr tht 

output dtvict 

it given. 
RI'Dtfault Auto 

Incrtnent (DRT 

or Unit) 

RR'Auto Reply 



Paraneter R 
64 
66 
68 
70 
72 
74 
76 
78 
80 
82 

128 


cord CCont. ) 


Sysdunp/Initial/Store 

DVR TABLE 
LPOT 
LOT 
IDTX 
DCTH 
CLASS 
TERM DEF 
ADD' L DVR 
CS DEF 
CS TABLE 

.00 

9 


Sysdunp/Initial/Sto re 

Driver Table 

The Driver Table consists of 7 ward entries, in correspondence to 
the LDEV entries, up to the highest LDEV used, entry zero is a 
durniy entry. 


REC ft 
LENGTH 


REC * 
LENGTH 


I 
DS 


1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


TYPICAL ENTRY 
FORMAT 


DRT * 


REC * 
LENGTH 


:R| CHAN * I |DS| UNIT « 


HASTER LDEV 




REC # 
LENGTH 


D | R 


I ! v 


REC # 
LENGTH 


N | R 


11 1 E 


REC * 
LENGTH 


DS DEVICE (if set DRT is zero! 


REC « 
LENGTH 


CHAN ft CHANNEL • 

MASTER LDEV LDEV of device uhich this DS device is linked to. 

Uords 3-7 contain the driver nane. 

G.01 .00 
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REC * 
LENGTH 


REC 8 
LENGTH 


REC II 
LENGTH 


UNUSED 


G.01 
16- 


I 
I 
I 
-> 


Sysdunp/Initial/Store 
SYSDUMP Fornat 


SY 


tdunp/Initial/Store 
•DUMP Fornat (Cont. ) 




CHECKSUM 
AHIGO CHANNEL PROGRAM 
UCS TABLE PRT 


o machines) 

95 
127 

Only for the 64/68. Refer to the 
UCS Table for the 64/68 belou. 

< — ENTRY POIHT #2 (UCS BASED 
MACHINES) 

127 

* 
ft 




INITIAL'S DB AREA 


ft 
ft 
ft 
ft 

ft 
ft 

! 


STACK MARKER 


ANIGO 


DRIVER TABLE 


UCS TABLE 


LPOT 


UCS #1 


LOT 


UCS «2 


IDTX 


UCS «n 


INITIAL'S SEGMENTS 


CHECKSUM 

nniGO 


RIN TABLE 


LOGGING IDENTIFIER TABLE 


AMIGO 


DIRECTORY HEADER 


ICS 


DIRECTORY 


LOU CORE 


xxxxxxxxxxxxxxxxxxx EOF XXXXXXXXXXXXXXXX 


Initial CST 


SYSTEM PROGRAMS, SL, NON-STD. DRIVERS 


CS TABLE 


XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 


DEVICE CLASS TABLE HEADER 


STORE/RESTORE HEHDER 


DEVICE CLASS TABLE 


XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 


TERHIHAL DESCRIPTOR TABLE 


STORE/RESTORE DIRECTORY 


TABLE LOOKUP BUFFER 


XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 


vise 


USER FILES (SEPARATED BY "EOF's" 


OLDVTAB 


STDRE/RESTORE TRAILER 


DISC COLD LOAD INFORMATION TABLE 


XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 


CTAB 


XXXXXXXXXXXXXXXXXXX EDF XXXXXXXXXXXXXXXX 


CTABO 


XXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXX 


COnnUNICATION RECORD 




CSDVR 


i 




CSDEF 

G.01 

16- 


.00 

11 


NOTE: ON DISC, READ-SI0-PR0GRAI1 KEPT IN DISC LABEL. 
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USC Table Fornat 



* Record! to UCS 

• Records of UCS 

I Records if ter UCS 
UCS Record Size on Tape 



Note: Currently only one entry used (Entry 4, by Series 64). 
Series 64/68 UCS Table Fomat 



-I- 



128 Uord | UCS 
Header | 



-I- 



I UIT 
I 



-I- 



Dicrocode Version (8 Bytes RSCII) 



• of UCS LOCATIONS (64 Bit Uords) 



» of UIT LOCUTIONS (32 Bit Uords) 



UCS CHECKSUM 
UIT CHECKSUTI 



c-.ot.oo 
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Store Taee Fornat 




First Volune 






1 xwoowxxxxxioaocxxx eof KxxxxxxxnciKXKHOaa 




1 KXKKffiOOOWXKKCXKXH EOF XHWOOOXKOiXXXXJOOa 






I "STORE/RESTORE UBEL - 
I HP/3000." 


1 
13 




1 "VIIB" 


14 

15 




I PRRTIP.L FIRST FILE FLRG 


16 
17 

18 
19 




I CHECKSUTI 




I DIRECTORY INDEX OF FIRST FILE 


HEADER 
40 UORDS 






22 




I VOLUNE NUtBER 


23 




i DHTE 


24 

25 
26 


DOTE: 
0:7 last 2 digits 

of year 
7:9 Julian date 


i TINE 


I TRPE6L0CKSHE (*U0RDS/BL0CK;def<4096) 


27 
28 

39 


TINE: 
25.(0:8) hours 

(8:8) ninutes 
26.(0:8) seconds 

(8:8) .1 sees. 
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First Volune (Cont.) 



I 1 

KXXXKXHXNXXXXKXXXXK EOF XXXXXXXXXXXXXXXXXXI 




FILE N9TIE i 


GROUP NDNE ! 


RCCT. HBtlE 1 




xxxxxxxxxxxxxxxxxxx EOF XXXXXXXXXXXXXXXXXXI 


FILES 


(separated by "EOF's") ! 



\ 

ITYP FILE 
I ENTRY 
1(12 UDS.) 

I 



Sysdunp/Initial/Store 



\ 

I 

I 

I 

I 

I 

I VOLUNE 

I DIRECTORY: 

I 4 ENTRIES 

I DCTERMNED 

I BY TRPEBLOCK- 

I SIZE 

/ 



Sysdunp/Initial/Store 



\ 

I FILES 

I 

/ 



Subseauent Vol 


VI? 


13 

14 
15 

16 FLW-1: 
1st FILE 

17 ON THIS 
VOL IS R 

18 PHRTIRL. 

19 
22 

23 

24 

25 

26 

27 

28 

39 

\ 

ITYPICRL 
1 FILE 
| ENTRY 
/ 




I "STORE/RESTORE LRBEL- 
I HP/3000." 




I TOT 

i 

I PMTIRL FIRST FILE FLR6 




j CHECKS!". 

1 DIRECTORY INDEX OF FIRST FILE 


HERDER 
40 UPS. 


1 V0LW1E NuTflER 


i DRTE 




1 TINE 
1 




i TRPEOLOCKSIZE 






NOTE: NO EOF 


1 FILE NWS 




1 CROUP HRNE 


VOLUME 
DIRECTORY 


! RCCT NWIE 


IXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXXX 




1 <FILES> 

1 (separated by "EOF's) 


FILES 
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End of Volune 

1 <FILES> 

i (separated by "EOf't) 




13 

14 
20 
21 
22 
23 
24 

25 

26 

27 
35 


FILES 


xxxxxxxxmxxxxxxm eof xxxxxxxxxxxxmxxx 




i "STORE/RESTORE UKL-HP/3SOO." 








I FUG: PRECEDING EOF HARKS FILE ENDED 


TRAILER 


1 FUG: PRECEDING EOF HARKS TBPESET ENDED 


40 UOS 


I VOUH1E NO. 




I DATE 




1 Tins 








IXXXXXXXXXXXXXXXXXXX EOF xxxxxxxxxxxxxxxxxx 




IXXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX 




IXXXXXXXXXXXXXXXXXXX EOF XXXXXXXXXXXXXXXXXX 

1 
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CHBPTER 17 niSCELLBWEOUS 

labeled Tape Subtvsttn 



The NPE labeled tape subtytttn pernitt convenient access to tapet labeled to 
either ANSI or 1811 standard!. It operetta aa a att of subprocedures to tha 
file systen. fl libeled tapt eonaiatt of ont or non logical files. Each 
logical fill consists of three physical filet, i. a. tape treat delimited by 
tapenarks. Tha first physical file contains header labels, the ttcond con- 
tains the data, and the third contains trailer labela uhich are (except for 
ninor differences) copies of the header labels. The tapt nark following 
trailer labela Kill be folloued either by header labels for the next file, or 
by another taoenark if there is no next file, labels are 80 bytes long, and 
conventionally are identified by their first four characters (three letters 
and a digit) and contain information as follows (CP :* character position; 
L:> length): 

V0L1 : Present only on the first file of a volune, the volune label contains 
the volune identifier, uhich is usually the nunber on the tape strap, and is 
thus not expected to be changed. 



CP I 



11/31 Label identifier 



I L I 
-I 1- 



I 4 I Label Nunber 



I 3 I "VOL" 
-I 1- 



I- 



-I- 



I 1 I "1" 
-I 1- 



5/10 I Volune Identifier 
I 1 

i 11 | Accessibility 

| 1 

I 12/79 I Not used 

I 80 I Label-Standard Version | 1 i "1" if HP AHSI else 



I 6 I Vol ID 
-| 1 

I 1 I "0" if IM, else " " 
-| 1 

I 62 I Blanks 
-I 1- 



UVLn: User volune labels, hay be present on tapes fron foreign shops, 
but are not written by HPE. If encountered, they are ignored. 
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Labeled Tape Subtysten 



H0R1: First header label. Required for each file. Specifies: 



CP 


Field Nana 


L 


Content 


1/3 


Label identifier 


3 


"HOR" 


4 


Label Nunber 


1 


"1" 


5/21 


File Identifier 


17 


File nane, if tape uas not 
written by HPE, only the 
first eight are significant. 


22/27 


Volune Set Identifier 


6 


Nanes the volune on uhich 
the set of files begins 


28/31 


Reel Nunber 


4 


Counts the reels that 
contain this fill (1 starts) 


32/35 


File sequence nunber 


4 


Counts the files in the set 
of files (1 startt) 


36/41 


Not Used 


6 


nPE urites blanks 


42/47 


Creation Date 


6 


Year and day uithin year 
uhen the file uas written. 


48/53 


Expiration Date 


6 


Year and day uithin year 
uhen the file nay be over- 
uritten uithout permission. 


54 


Accessibility 


1 


K30 if lockuord, "0" if IBH 


55/60 


Block count 


6 I Hunber of blocks if IBH. 


61/73 


Systen Code 


13 1 "HP BPE 3000 " 


74/80 


Not Used 


7 I Blanks 
-* 
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HDR2: Second header label. Hlthough defined by the standard, nay be 
nissing on foreign tapes. Contains: 



I CP I 



11/31 label identifier I 3 

| J 1 

I 4 | label Nunber I 1 



-I- 



i 5 ( Record Fomat 
I I 

I ! 



6/10 I Block Length 
I 



1 

"F" = Fixed I 

1 "V" = Variable I 

I "IT = Undefined I 

I Others treated as Undefined j 
-I 



-I- 



| 11/15 I Record Length 



-I 1- 

I 5 I Block length (in character | 
I I fornat). I 

-I 1- 



-I- 



16/23 I Lockuord 



j 5 | Record length (adhering to i 
i I to HPE rules) in characters.! 
-I 1- 



24/36 I Not Used 



-I- 



I- 



37 j Record Type 
I 



I 8 I HPE File Lockuord. 
-| 1 

I 13 I nPE urites blanks 
-I 1- 



-I- 



I 1 I "A" 

I I "6" 



= ASCII 
= Binary. 



I 38 I Carriage Control 

I i 

I -I 

I 39/80 I Not Used 



-I 1- 

I 1 I "C" = control 
| j " " = no control. 

-I— -I 

I 42 I Blanks 



G.01 .00 
17- 3 



Labeled Tape Subsysten 

IBH has a slightly different fomat. It is: 

* 

CP I Field Nane 



1/3 
4 



6/10 



11/15 



18/38 

39 



Label identifier 



Label Hunber 
Record Fomat 



L I 
-I- 



3 | "HDR" 
-I- 



1 | »r 



Block Length 



Record Length 



16(1 Position 



Hot Used 

IBtl Block Attribute. 



40/80 I Not Used 



I "F" = Fixed 

1 I "V" = Variable 

I "U" - Undefined 

I Others treated as Undefined 



5 I 



81ock length (in character 
fomat). 



Record length (adhering to 
to HPE rules) in characters. 



— I- 
1 I Blank. 



-I- 

1 I 

I 

-I- 



'0" = no volune switch 

'1" = a suitch has occurred. 



11 I Blanks. 



-I- 

I 
1 I 



'B" - Blocked records. 

'S" = Spanned records. 

'R" = Blocked and Spanned. I 

" = No blocked or spanned. i 



41 | Blanks 



G.01.00 

*17- 4 



labeled Tape Subtysttn 

liter header libtlt: optional. Standard prescribes UHLn in tht fint 
four characten, but HPE doesn't cart. 

E0V1: End of Volunt; uttd at fint trailer label. Required if the 
logical file it continued onto another reel. Identical to HM1, except 
contain! the nunbtr of physical blocht of data in tht data area. 

« , 

I CP I Field Nam I LI Content I 

| 1 . 1 1 1 

I 1/3 I Label identifier | 3 | "EOV- 

| 1 1 , 1 

I 4 | label Hunter | t | "1" j 

| 1 1 1 1 

I 5/54 I Sane at HD81 I 50 i | 
j j 1 1 . , 

II II Runber of data blocks since I 
I 55/60 I Block Count j 6 I last beginning of file j 
SI f I taction label group. j 

I 61/SO I Sane as »«1 | 20 I "" j 



E0V2: Defined by the standard, but nay be nitting on foreign tapes, rollout 
E0V1; fomat sane as HDK2. 

E0F1: End of File; uttd at fint trailer label. Required if this it the end 
of the logical file. Fornat sane as EDV1. 

E0F2: Sam as EOV! swept used after EOF). 

liter trailer labels: optional. Standard prescribes UTLn in the fint four 
characters, but NPE again dottn't can. 
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[hiring PROGEH, SETUP' TAPES is called to initialize the table. The overall 
structure of the initialized TLT is: 



TLTOST - J32,»26 TLTSIR - H7.M9 

1 2 3 4 5 6 7 t 9 10 11 12 13 14 15 



Table initialization uord («1 uhen initialized) 



Entry size (ESIZE) • 132,1126 



Table relative pointer to base of LCS entries (LTBRSE) (1) 



Table nlative pointer to base of VC8 entries (VTBRSE) (2) 



Table relative pointtr to top of Volunt table (VTTOP) (3) 



Size of Tape Label Table, in uordt (VTKftt) 



LDEV Control Block »n* — one entry/nag tape drive 



I 30 

I 
I 31 



I 32 
I <-(D 



Volune Control Block table -- contains VCB entries 
and free entries 



Rr*a available for expansion of VCB tabls 



I 
-I 
I <-(2> 

I 



I 
-I 
I <-(3) 
I 
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Taoe Label Table 



The tape label table it the private playground of the tape label subsytten. 
It consists of tuo parts: LDEV Control Blocks (LCDs) and Volunt Control 
Blocks (VCBs). Tht IDEV area it set up at systen initialization and contains 
one entry for each negnetic tape LDEV and serial disc device in the systen. 
At is coition in BPE, tht fint entry it a dunny uhich tells uhen tht other 
tilings in the table an. The volune ana contains one entry for each labeled 
tape volune requested or active on the tyttm. 

Although table entries in stored in an extra data segnent, they an gener- 
ally nanipulated via local copiet on tht stack. The procedures GETLOEV and 
GETFKuTI look For LDEV and volune entriet at specified; they copy then to 
stack buff en and ntvm tht DSi address for use in copying then back. 
POSTVTEHT copiet the entriet back, and in tht cast of a neu volune entry, al- 
locates space for it in the volune section of the tape label table. 

Initial uili build the "uninitialized" TLT as follow: 



5 6 7 B 9 10 11 12 13 14 15 



I Size of the table, in uordt (aluayt > 1 ) 



Hunbtr of LOWS in the table ' X 



.fla«"1 
I 



I 



I 1 
-I 



LOEVR 



Total of LDEVS !X) entriet of above 



IT I 2 
1 

I 



LDEV* 



Expansion ana 
during SETUP'TBPES 



IT I X»2 
1 

I 



T: 1 if Tape drive if not Tape drive (i.e. terial disc) 
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ICB Entry fornat 



The ICB entriet have the follouing structun: 
1 2 3 4 5 6 7 < 9 10 11 12 13 14 15 



I Type | T | L | B I HP| 



Logical device nunber 



VCB address 



File sequence nunber 



Creation date 



Expiration date 



File i 





1 

2 

3 

4 

5 

6 

7 

I 10 
I 

I 

I 16 
-I 
I 17 



4 



(not used) 



Volune set identifier 



Volune identifier 



I 20 
I 

I 21 
I 

I 22 
I 
| 23 

24 

25 

26 

27 

30 
31 
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Type: 00 ■ no taps nounted 

01 • unlabelled 

10 > ANSI 

11 » 1611 

L: 1 if file has lockuord. 

T: 1 if device it a tape drive. 

B: 1 if tape ie fron Burroughs, uhich has incorrect block/record size 

in the HDR2 label. Code can be patched to correct the size. 
HP: 1 if tape is Heulett-Paekard ANSI fomat. 

VCB address: Pointer to VCB entry describing volune nounted on 
tape drive, only if linked. Otherwise, 0. 
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VCB (Cent.) 



Labeled Tape Subsysten 



I 26 



Volune nane 



I 27 
I 
I 30 



I 31 



fl: ASCII FOPTIOH 

F: Flush bit - operator did REPLY <pin>,0. 

D: DEVREC Uait (used uith reelsuitching). 

Position: Gives head position uithin logical file. 

= at load point (LOPNT) 

1 = HDR1 label next (H1NX) 

3 * after HDR2 label (BH2) 

4 = after user header labels (BHU) 

6 = data next (ONX) 

7 = after data (BD) 

8 = E0F1/EOV1 label next (T1NX) 

10 = after EOT2/E0V2 label (BT2) 

11 = after user trailer labels (BTU) 
U: Urite access specified. 

SeqTyp: File open sequencing type. 

= natch filenane 

1 = NEXT 

2 = RDDF 

3 - use file sequence nunber 
LblTyp: Bs in LCB entry. 

L: Linkuait - nark left by CREBTETLTENT for LINKLBBEL. 
H: Hount uait - uaiting for operator to nount tape on FOPEN. 
R: Reelsuitch wait - uaiting for next reel. 
B: Busy bit - this entry is in use. 

LDEV 8: Logical device nunber of tape drive uith this volune, only if 
linked. Otherwise, 0. 

S: STORE tape. 

R: REELSUITCH has been done. Used by STORE/RESTORE to handle STORE 
label and directory file. 

D: Next file is directory. Used by STORE. 

C: V0L1 label is to be created (written). 

Density: volune set density. During a volune set open, contains the 

density requested by the user in FOPEN. Once the volune set is 
open, contains the actual density of the volune set. Only 
valid for tapes on variable density tape drives. 

= default density for volune set open 

1 = 1600 BPI 

2 - 6250 BPI 

V: 1 if volune set is being opened. Reset after conpletion of FOPEN. 
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VC8 Entry Fomat 

The VCB fomat is: 

1 2 3 4 S 6 7 ! 9 10 11 12 13 14 15 
F I D I Position I U | SeqTyp I LblTyp I L I fl I R | B 



I B 



LDEV # 



PIN 



File nunber (AFT index) 



I S | 



File sequence nunber 
R I D I C I Density I V I Reel nunber 

Expiration date 
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Volune Recognition 



Volune recognition is the responsibility of DEVREC, which reads the first 
record of a newly-nounted tape on an unowned drive and passes the record to 
BVREC. BVREC nay see: V0L1 in the first 4 bytes, in ASCII, in uhich case the 
tape is ANSI; V0L1 in the first 4 bytes, in EBCDIC, in uhich case the tape is 
I8f1; Anything else, in uhich case the tape is considered unlabelled. 

If the tape is unlabelled, BVREC reports to DEVREC that no further action is 
required. If the tape is labelled, AVREC uants to see the first HDR1 label, 
so asks DEVREC to read another record. (Unfortunately, DEVREC cannot be stop- 
ped long enough for AVREC to do its own read.) Uhen the HDR1 record is 
found, the volune entries can be searched to see if there is a pending 
request for this volune. If so, the uaiting process is restarted. 

If the systen has been restarted with tapes nounted, there uill not be inter- 
rupts to alert DEVREC. The procedure RECOGNIZE is called uhen needed to see 
if any such tapes exist. 



Opening a File 



FOPEN gets into the tape label cade in three different places. The first is 
to call CREBTETLTENT, uhich parses the string passed in the F0RHSI1SG parane- 
ter to identify the labeled tape file required. If there is no existing cor- 
responding entry in the volune am, this is a volune set open, and a neu 
volune entry is created. There nay be an existing entry (if the tape uas 
FOPENed and FCLOSEd with disposition 2 or 3), in uhich case there is an as- 
sociated LDEV entry for the drive on uhich the tape uas left nounted by the 
prior operation; in this case, the neu infomation is stuffed into the exist- 
ing volune entry. A bit (LINKUAIT) is left set to nark the entry for 
UHKLABEL. 

The second entry is through LINKLBBEL, uhich is called fron ALLOCATE. Bt 
this tine, it is necessary to identify the LDEV to be used for the tape. If 
no LDEV is associated, the LDEV entries are searched to see if the operator 
has already nounted the required tape; if so, the volune and LDEV entries are 
cross-tied and LINKLBBEL is done. If the search turns up nothing suitable, 
the operator is requested to nount the appropriate tape, and the procedure 
uaits for either a REPLV or for AVREC to discover the appearance of a 
suitable tape and restart the process. If the operator enters a reply, it is 
validated. 

The third entry is through POSITION, uhich is responsible for positioning the 
tape to the requested file. At the file, the HDR1 and HDR2 label are ex- 
anined as required to detemine the file characteristics. 

Reading and Uritinq Files 

All procedures uhich nove tape go through the catchall procedure CHECKUL, 
uhich takes care of necessary labeled tape doings. The code insures that the 
sequence: header labels (including user labels), data, trailer labels 
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(including user label*) it naintained. There it a separate CflSE leg for each 
such procedure. 

If an EOT reflective nark or an EOF in data it found, REELSUITCH it called 
(principally fron the file systen procedure IonOVE) to call for the next 
reel, if any. If another reel it needed, the tape drive it tet Unouned to 
-that AVREC Hill be called to recognize the neu tape when it it nounted. 
REELSUITCH returns to itt caller uhen it it tatitfied that an appropriate 
tape it nounted. 

Clotinq filet 

FCLQSE calls CHECKUL to handle uriting E0F1 and E0F2 if needed and resolving 
the tape position. If the dispotition is 3, the tape is left positioned at 
the next file. If the disposition it 2, the tape is supposed to be left at 
the beginning of the current file, but the code does not presently provide 
for reelsuitching if the present file began on a prior reel. 

fit present, ensuing volunet of a nuiti-volune set mitt be nounted on the sane 
drive as the first, Mostly because neither the file systen nor STORE-RESTORE 
Has capable of dealing uith LDEV changes in the niddle of a file. REELSUITCH 
reports the LDEV being used, however, so that the capability of using a dif- 
ferent LDEV can be added in the future. 

Store-Restore 

Complications ensue on labeled STORE-RESTORE tapes because there needs to be 
a file directory at or near the beginning of each tape of a nulti-volune tet; 
RESTORE utet this directory to determine uhether the specified file(t) can 
exist on this tape. Because the reel snitching process uould otherwise be 
invisible to STORE-RESTORE, special bits (VCB'RSUDONE and VCB'URITDIR) are 
kept to enable special intrinsic! callable by STORE-RESTORE to report uhether 
a directory needt to be uritten or it about to be encountered. 

The special procedure NEXTTAPEFILE is used by STORE-RESTORE in lieu of doing 
a FCL0SE(,3) folloued by an FOPEH to get to the next file. This pernits 
cleaner handling of both REPLY and Forward Space (logical) File over a 
Reeltuitch, as uell as saving the tine needed to tear down and reconstruct 
all the control blocks. 

fliscellaneous 

PVOUD is used by the SHOUOEV connand processor (in SP00LC0HS) to obtain the 
nane of the volune on the specified drive uithout having to knou the struc- 
ture of the tape label table. For the sane reason, TCETINFO is used by the 
FFILEIHFO intrinsic (in FILEIO) to get labeled tape information. 

Systen failure 86 in ItPE is defined as a najor problen in LRSSEG. Generally 
speaking it it a problen uith the TLT setup, for example if LA6SEG cannot 
find an LDEV in the table. 



0.01.00 
17- 13 



Breakpoint Table 



Breakpoint Table 



DST * 30(10) ' Z36 

The break point table is divided into 2 section: 

1) PCB BREAKPOINT EXTENSION TWLE (PCB'EKPT'EXT) 
This table contains the heads of the breakpoint 
chains 

2) BREAKPOINT ENTRY TABLE (oWF ENTRY' TAB) 
This table contains the actual entries 

General layout 



PCB(IS) 



I 

I 
I 
I 
I 
-> I- 



I I- 
I I 
I I 



I I 



SYS GLOBAL 

14:15 



I I 

I | BKPT' ENTRY 'TUB 

I I 

| | 



125 I 



ILISI 



I I- 
I I 
I I 



L = Table locked 

S * Systen break 

points exist 



I I- 
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Breakpoint Table 



PCB Breakpoint Extension Table 



| « ENTRIES | ENTRY SHE ° 1 

| HERD SYSTEN LIST I FREE ENTRY * 

| N USED USER ENTRIES I ACTIVE ENTRY = Index 1tt Entry 

in breakpoint 

I I chain 

USER ENTRIES 



I 



Breakpoint Entry Table 

ENTRY (0) 






FREE ENTRY 







|« UORDS BREAKPOINT TAB I 


11: 

1 


SIZE 
FORUARD LINK 


1 


1 


I HERO FREE LIST 


1 


1 


2 


| «. UORD USED 


! 


1 


BACKUARD LINK 


1 


3 


I I1BX * UORD USED 


1 


1 
1 

1 
1 




1 


4-6 


1 UNUSED 


1 






LAST ENTRY 




1 
1 





1 


11 









Active Entry 



0|1|2I3|4|5I6|7|>|9|0|1|2I3|4|5 



iO|P|L|V|D|F|T|U|P|Clt)l SIH 

I I I I I I I im |P| 



UNUSED 



DLOCKIRKL 



PLOC 



INSTRUCTION 



LINK 
USERlRotL 



CONDITION/COUNT 



COND DESCRIPTOR 



The breakpoint entry table contittt of variable length entriet 
The nininun entry size it 7. 
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ENTRY(0).(0:1) = FR: 
ENTRY(0).(1:1) = P: 
ENTRY(0).(2:1) = L: 
ENTRY(0).(3:1) = V: 
ENTRY(0).(4:1) - D: 

ENTRY(0).(5:1) = F: 
ENTRY(0).(6:1) = T: 
£NTRY(0).(7:1) = U: 
ENTRY(0).(8:1) = PB: 
ENTRY(0).(9:1) = C: 
ENTRY(O).(10:1) = UP: 



ENTRY(1).(0:1) = II 
ENTRY16) = UKK: 



FREE ENTRY 
1 = FREE 

= USED 

PRIVILEGED H0DE BREAKPOINT 

1 = PRIV. 

= NON-PRIV 
PROCESS-LOCAL BREAKPOINT 

1 = PROCESS-LOCAL 

= SYSTEn 
VALIORTION BIT 

1 = INSTRUCTION IN ENTRY(3) 

= INSTRUCTION NOT IN TAB. 
DOUBLE TRAP 

1 = BREAKPOINT OSCILLATES BETUEEN 

P/P+1 

= NOT DOUBLE TRAP 
FAKE "DUtinV TRAP 

1 = BREAKPOINT AT Pt1 

= BREAKPOINT AT P (ORIC-. LOC) 
TUO UORD INSTRUCTION 

1 = TUO UORD INSTRUCTION 

- NOT TUO UORD INSTRUCTION 
USER LABEL PRESENT 

1 = TRAP TO USER SUPPLIED LABEL 

- TRAP TO OEBUC- 
PERUHNENT BREAKPOINT 

1 = PERU 

= TEBPORARY 
CONDITION/COUNT 

1 - CONDITION/COUNT SPECIFIED 

= NO CONO/COUNT 
UPDATING 

1 = ENTRY IN PROCESS OF BEING 

UPOATED/REnOVED 

= NOT BEING UPDHTED/REnWED 
USER PLBBEL BODE 
LINK 

= END OF CHAIN 

>0= INDEX NEXT ENTRY 
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Breakpoint Entry Table (Cent. ) 
COUNT 
1) | ORIGINAL CNT. I 
I * OF HITS | 

I 1 I 



CONDITION 

2) | OPERANDI I 

I 0PERANO2 | 

|0PT1|0Pt2| RE LOP | 



RELOP -> (8:8) RELOP NU11BER: 

3 = LT 9 = LTE 

4 = GT 10 - GTE 

5 = EQ 11 = NEQ 
0PT1 -> (0:2) OPERANDI' S TYPE 
0PT2 -> (2:2) OPERRMK'S TYPE 

OPERAND TYPES: 

-> CONSTANT (SINGLE UORD) 

1 -> ADDRESS (DOUBLE UORD) 

3 -> INDIRECT ADDRESS (TRIPLE UORD) 



OPERAND FORHS: 
CONSTANT -> 

ADDRESS -> 




I CONST ! 


I REG | BASE | 
I OFFSET | 


REG -> 
BASE -> 


IIND. OFFSETI (TYPE 3 ONLY) 

(0:6) CORRESPONDING INDEX INT 

3 = A 10 = DL 

4 = SY 11 * g 

7 = DA 12 = S 

8 = DX 17 = EA 

9 = DB 
(6:10) SEG #7BANK I 
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Tiner Request List CTRL) 



The systen clock interrupts every 100 ns, with the CR being autonatically 
cleared. An exception is the Shared Clock Interface neasurenent service 
which allous rates as fast as 5 ns. The interrupt handler is the procedure 
TICK. On entry, DB is pointing to the base of tiner request list. Besides 
tineout requests, the clock also controls tine slicing. 



NUflBER OF ENTRIES 



ENTRY SIZE (4) 



FREE LIST PTR 



/0| 
! I- 
I 11 
ENTOI |- 
I 21 
I I- 

\ 31 K of days since last start 
| 

/ 4| QUANTUII/100 ns 

| | 

I SI 

| | TIBE OF DAY* 

ENT1| 6 | 

j | — 

\ 7 | YEAR | JULIAN DAY 
| 

/ 8 1 PTR TO HOST ACTIVE REQUEST 

! I 

I 9 | TRACE UORD 
ENT2I | 

1101 

I I 

\11| o 

I - 

/12|A| CODE I INDEX OF NEXT 
I I 

1131 REQ 
ENT3I I 

I I TII1E TO SERVICE AFTER 
\ | REQUEST IN FRONT (UNIT* 100ns) 
I— 

I 
I 
A: if inactive request 
1 if active request 



Tiner Request list 




TRL fCont.) 




CODE & REQ indicate the type of 


request. 


CODE: REQ: 


TYPE: 


DITP 


Hangup 


1 DITP 


Carrier failure 


2 DITP 


202 turnaround 


3 DITP 


Read 


4 DITP 


Logon 


5 PCB8 index 


Delay 


to process 




6 DITP 


LP not ready 


7 DITP 


2640 


Z10 Port nask 


flsg port tineout 


Z11 DITP 


Block node read 




tineout (30 sees) 


21 2 PCBB index 


Uatchdog tiner for 


to process 


process 



HP-IB Systens only 
QTIflE 

DTWE* 



The list of pending requests is kept ordered by tine uith later 
entries at the tail. 



DITP 



tb/xe 



$10 device tineout: 
DIT8. (code J on 
expiration, cleared 
on Tinereq. 

For Series 30/33, DTin£ is 
41 of TICS (0.091457 ns) 
since last nidnight. 



dunny tine 

i 



assignable 

entries 
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Timr Rtquttt Lilt 


Timr Request tilt 


WE Uttr Lottint 


Error Neoverv Gtteriotion 


I1PE USER LOGGING tnablat uiiri and subay stint te log changaa to data fits on 


Tht trror rtcovtry ntchtnient provldtd by Uttr Logging art: poutr fall 


disc or ttritl filn. Thit "chtngt" fill cm littr bi utid to ncovir diti 


rtcovtry and rtcovtry fron systtn failure. 


loot dui to i lyitm or progran failun. Thi log fill cm itulf bt uitd for 




auditing purpoata. 


Poutr failure rtcovtry applitt only to tapt log filtt ainct NPE providts 
adtquatt rtcovtry for ditc filtt during poutr fail. Uhtn a poutr failure it 






dtttcttd, a nttaagt uill bt printid on tht eonaolt asking tht optrator to 


Gintral Dunn Overview 


pltct tht tape drivi back on-lint. (If thi optrator placet tht tapt on-lint 




btfort tht nttaagt valid data nay be overwritten). (To reatt tht tapt drivt 


Hardware Environnent 


the optrator ptutt hit tht load button until tht ttnsicn returns to the drivt. 




Than hit the nttt button folloutd by placing tht tapt drivt back on-lint). 




fit thit tint tht log proem uill rtcovtr tht filt by rtuinding to tht load 


No iptcial harduart it rtquirtd to opirata thi aytttn, Nouavir, if logging to 


point and then forward apacing to tht point uhtn tht poutr fail occurnd. 


a tap« filt ia dtsind, th< harduart configuration mist ineluda a tapt drivt. 


Writing to tht log fill uill continut at that point. 


If thin is no tapi drivi, than nay log to a atrial disc class dtvict. 






In tht tvtnt of a tytttn failun, tht uam start load option initiates 




rtcovtry of Ussr Logging filtt. In tht caat of a ttrial fill, tht filt ia 


Softuart Environntnt 


read and conpand to tht disc logging bufftr. Rll ncords found in tht ditc 




bufftr that an not on tht atrial log filt an posttd and a proptr end of 




filt uritttn. If tht dtstination filt it a ditc filt, all ncords an nad 


NPE Uttr Logging it an inttgral part of HPE. Ho othtr sptcial softuart is 


and vtrifitd and an tnd of filt posttd to tht filt. In order to continut 


rtquirtd. 


logging to a Uttr Logging filt that hat bttn ncovtnd in this narmtr, tht 




logging proctss for tht filt nutt bt restarted using the conaole connand 
:L0G. 




NOTE; 


Pmian ">t«Uyi 


Any ncords in tht bufftr ana of tht logging bufftr uill bt lott. 




User logging hat bttn tnhanctd to work with labtltd serial discs. 


Ustr Logging tnablts ustrs an^ subsysttnt to journalist additions and 


Internally the log process handlet strial disc (or cartridgt tapt) 


nodifications to RPE and subsysttn fiits. Tht journal can rtsidt on tithtr 


log filtt tht sane aa for tapt filtt. 


disc or serial logfiltf , 




Ustr Logging consists of a logging proctss, a ntnory bufftr, a disc rtsidtnt 




logging bufftr (for atrial logging) and a ustr dtfintd dtstination log filt 




on disc or atrial ntdia. 




Tht logging process has tuo functions depending on Hhtthtr the destination 




filt naides on disc or aerial ntdia. If tht dtstination filt is atrial, tht 




logging process performs all output to tht dtstination filt. If tht destina- 




tion file is on disc, tht logging proctss allocates additional apact (ex- 




ttnts) aa it ia required by the user. 




Tht logging bufftr is dividtd into conmtnication and bufftr areas. The con- 




mmication ana is ustd to pass infornation anong tht ustrs and tht logging 




proctss. This infornation includts status of tht logging process and logging 




filt, space rtnaining in tht logging filt and error infornation inportant to 




users or the logging process. Tht buffer portion of tht logging data segnent 




blocks inputs into tht logging filt before tht data is actually posted. Tht 




bufftr it flushtd any tint a ustr rtqutsta to cloaa a log filt or uhan a log- 




ging proctss is teminated. (Tht buffer it also flushed by tht btgin/tnd 




transaction or bufftr flush rtqutsta). 
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Ustr Logging Tablt 


Uttr Logging Tablt 


Design Structures 


NuTIENTRIES 




Tht nunbtr of tntritl in tht logging tablt. 


User Loqqinq Table 






FREE 


ENTRY SIZE * »38 uords 


R tablt nlativt pointer to tht first free entry in tht logging tablt. (-1 * 


DST X33 


tablt full). 




INUSE 


Tablt containing an entry for tach activattd ustr logging proctss. Each 


R tablt relative pointer to tht fint tntry in the logging table that if 


entry it created uhen the proctss is started, and dtltttd when tht proctss 


being uttd (-1 * no entries in use). 


ttminatts. (Via :L0G connand). Tht infornation is extracted fron the Logging 




Identifier Table (UDTR8). 


auFNun 




Tht nunbtr of tht bufftr associated uith this logging proctss. Used to cre- 
ate the nane of buffer file if serial logfile. (i.e. ULOGxxxx.PUB.SYS). 




ENTRY 


riRXLOGPROC 


« 


X 


Tht naxinun nunber of user logging processes alloued. 
NNX'USR'PROC 





NUnBER OF ENTRIES I 


1 
2 
3 
4 
S 
6 
7 

37 


1 


The naxinun nunber of usen per logging process. 

LOGTffl'ESIZE 

The size (in uords) of each entry in the table. 


FREE ENTRY HERO PT. I 1 


INUSE ENTRY HERD PT. I 2 
I 


NEXT BUFFER NUNBER I 3 


MX i PROCESSES I 4 


m i USESS/PWESS I s 

I 


I 6 


Entry SUE I 7 

I 


I 

I 

I 45 

I 


UCitD ENTRIES 




NUI1ENTRIES ■ LOGTRB 




FREE = LOGTRBO) 




INUSE = LOGTRBtf) 




BUTHun = LOGTRBO) 




nnxLOGPROT • LD0TBB<4) 




nflX'USR'PROC = L0GTRBI5) 




LOGTRB'ESIZE = L0GTRB(7) 
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User Logging Table 



Typical Entry 




LOGGING 
IDENTIFIER 



BUFFER 
NAUE 



FILE 
NflllE 



LOCK 
UORD 



24 

25 
26 



NUMBER Of USERS 



30 
31 
32 
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User Logging Table 



The r 



• of the logging process (logging identifier). 



BNAHE 

The nane of the disc buffer used if the logging process destination file is a 
serial file. This is a file that resides in PUB. SYS. The fornat of the nane 
is ULOGxxxx uhere xxxx is the buffer nunber padded on the left uith zeros. 

If the suitch flag is true, the following Hill be the fully qualified file 
nane of the neu log file. 

LFHBBE 

The nane of the logging file. 

LFLOCKU 

The lockuord of the disc logging file. 

LFGROUP 

The group that the destination logging file resides in if the file is a disc 

file. 

LFRCCT 

The account that the destination logging file resides in if the File is a 

disc file. 

NUnUSERS 

The nunber of users currently accessing the logging file. 

DST 

The dst nunber of the logging data segnent (LOCBUfF). (-1 = LOGBUFF not 

created yet) 

STRTUS 

The status of the logging process. 

INITIALIZING = -1 

INSCT = 

ACT = 1 

RECOVERING = 2 

LGAUTO 

True iF the autonatic changelog facility was enabled. (Not used - for future 

use). 

LGTYPE 

The type of destination file of the logging process. 

DISC = 

TAPE = 1 

SDISC = 2 

CTAPE - 3 

LGDEV 

The logical device nunber of the disc logging file or the disc logging 

buffer. 



27 
28 
29 
30 

31 
32 



36 

37 



TABINDEX 
BTABINDEX 
DTB8INDEX 

LGNAHE 

BNflnE 

LFNAnE 

LFLOCKU 

LFGROUP 

LFRCCT 

NUNUSERS 

DST 

STATUS 

LGRUTO 

LGTVPE 

LGDEV 

PIN 

LGSUITCH 

LGNEUAUTO 

LGNEUTYPE 

LGRDDR 

BSI2E 

NEXT 

PREV 



CURR RUTO I CURR TYPEI 

.I 

I 



LOG DEV 



SUITCH FLAG 



NEU AUTO | NEU TYPE I 
.1 



ADDRESS OF 
LOGGING BUFFER 



I 



I 42 



LOGGING BUFFER 



FURD ENTRY PT 



BURO ENTRY PT I 

I 



UORD INDEX TO CURRENT ENTRY 
BYTE INDEX TO CURRENT ENTRY 
DOUBLE INDEX TO CURRENT ENTRY 

8TABINDEX 

BTABIN0EX*8 

BTABINDEX*16 

BTABINDEX*24 

BTABINDEX*32 

BTRBINDEX<40 

TB8INDEX*24 

TABIH0EX*25 

TABINDEX<-26 

TABINOEX*2?.(0:8) 

TA8IN0EX*27.(8:8) 

TB8INDEX*28 

THBINDEX*29 

TflBINDEX*30 

TABINDEX*31.(0:8) 

TABIN0EXO1.(8:8) 

DTABINPEX*16 

DTABINDEX*17 

TABINDEX*36 

TABINDEXt37 
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User Logging Table 



The PCB nunber for the logging process (PIN * PCBSI2E). 

LGSUITCH 

Flag indicating a CHSNGEuiG is pending (if true). (Not used - for future 

use). 

LGNEUAUTO 

True if the autonatic changelog facility Has requested for the new log file. 

(Not used - for future use). 

LGNEUTYPE 

If a suitch is pending, this uill be the type of the neu log process. (-1 - 

no suitch pending). (Not used - for future use). 

LGHDDR 

Sector nunber of the current extent in the disc logging file or the disc 

buffer file. (Disc buffer file has only 1 extent) 

BSIZE 

The nunber of records in the current extent (for disc logging) or the nunber 

available in the disc logging buffer. 

NEXT 

R table relative pointer to the next entry in the logging table. (-1 = this 

is last entry) 

PREV 

A table relative pointer to the previous entry in the logging table. (-1 = 

this is first entry) 
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Uitr Lowing Bufftr 



Uttf Lawina Bufftr 

Thtrt uill bi ont of trait tablti around for tht lift of any tetivt uttr leg- 
ging proem. Tht ttbli eontitti of thrtt parti: 

HmiWUKBTIMS AREA - Information about ttatut of thi proem, itc. that it 
coraion to til won of tht proem. Alio tht ctllt for iwnagn to/fren tht 
proctti. 

USER ENTRIES - Infornation for • iptcific unr of tht proem. Dm 

of trait for ivtry uttr of a proem (Setup by OPENLOG, rtltaitd by 
CLOSE LOS). 

B4IFFER (WEB - Bufftr uttd to hold logging rtcordt fren all ultra 

btfort writing to tht log filt. 



„ cofimjNicnnoKS wed 




ENtRV «2 


FPflBPT 
1 


ENTRY «3 


FJTlPT 


enirVM 






EitTftv »n 


FPTIBPT 

1 .. . 


BUFFER AREA 
4K IHROS 
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X 
35 
3S 



48 

49 



SHE 

the- 

SPACE 

-nmr 



SIZE 



LAST EXTENl 



extent 



42 
43 



RESOURCE 



IN USE HEAD PTR 



FREE HERO PTR 



60 
61 



Uwr Logging Buffer 



0.01.00 

17 31 



r Logging Bufftr 

COfflttJNICATIONS AHA 


X 





LOGGING 
IDENTIFIER 





4 


SUlfCh" ELM 


4 


6 


NEu Aiito I it\i type 


S 


6 


Auto I TYPE 


6 


7 


BUffE* Pit 


7 


8 


LOG PIN 


10 


9 ' 


nuhbeR of IiSeas 


11 


10 


nta NuitSER Of uSeAs 


12 


11 


NfKt User nUhbep. 


13 


1! 


SLEEP UunT 


14 


13 


StfltE 


15 


14 


flSG 


16 


15 


lMiisc- 


17 


16 


IIKr HSS 


20 


17 


LOGErWR 


21 


IS 


LOG DEVICE 


22 


19 


Suffer sMcS 


23 


» 


We'd sMcC In buffer' 


24 


21 


FILE SET NUhKR 


25 


22 


LOG 
ADDRESS 


26 


24 


Input 

RECORD 


30 


26 I 

I 


FILE 32 
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Uitr Logging Buffir 




LOGIO 


BLOGBUFF(O) 


SUITCh" 


L0GBUFF(4) 


NEUAUTO 


L0CBUFF(5).(0:8) 


KEUTYPE ■ 


L0GBUFF(5).(I:S) 


ROTO 


L068UFF(6).(0:S) 


LOGTVPE 


L0GSUFF{6).(8:8) 


BOST 


L0GBUFF(7) 


LOGPIN 


L0GeUFF(8) 


MMSER ' 


U3GBUFF(9) 


IMXUSER' 


LOGBUFF(IO) 


U5ERM0 


UKBUFF(11) 


SLPCT 


L05BUFF(12) 


STATE 


L0GBUFF(13) 


DSG 


L0GBUFF(14) 


LOOKS * 


L0GeUFF(15) 


USEH1SG « 


L0GBUFF(16) 


LBGERR - 


LDGBUFF(1?) 


UffiOEV - 


LOOBUFF(IS) 


BSPACE • 


L00BUFF(19) 


BUFUSEO • 


L0CBUFF(20) 


VSETNO • 


L0GBUFF(21) 


LOGAODR • 


DLOGBUFFdl) 


IN8UFREC 


DLOGBUrF(IZ) 


FSIZE 


DLOG8UFF(13) 


FSPftCE' ■ 


DL0G8UFF(14) 


TRECS 


DL0G9UFFO5) 


IMNFSPACE 


DL0G8UFFO6) 


LflSTEKT' ■ 


L0GBUFF(34) 


EXTENT 


L0G6UFF(35) 


RESOURCE 


DLOGBUFF(li) 


UHEAO 


L0GBUFF{48) 


FHEBO > 


L0G8UFF(49) 
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User Logging Buffer 


User Logging Buffer 


LDGID 


LOGHSG 


The name of the logging process. 


A Messages fron the logging process. 




6 - Continue processing, all is fine. 


SHITCh" 


15 - EOF - if there are no nore extents available to be 


True if log file switch is pending. (Not used - for future use). 


allocated. 




12 - Disc space - could not allocate the new extent because 


NEUAUTO 


no space left in the group. 


True if the autonatic changelog option has been specified for the neu log 


9 - Urite error - error occurred uhile writing to log file 


file. (Hot used - for future use]. 






USERtlSG 


NEUTYPE 


A messages fron the user process. 


If a switch iias requested, this will be the type of the neu logging file. 


6 - Continue processing, all is fine. 


(-1 = no switch pending) (Not used - for future use). 


12 - Disc space - user process needs another extent allocated 




for disc logging. 


fiiJTO 




True if the autonatic changelog option was specified for the current log 


LOGERR 


file- (Not used - for future use). 


Last error found. After changelog: 




+N - File Systen error nunber encountered 


LO&TYPE 


- No error 


The type of destination file for the logging process. 


-1 - Heu disc log file was not enpty 


DISC = 


-2 - Neu disc log file did not have file code LOG 


TfiPE = 1 


-3 - New disc file is too snail 


SDISC = 2 


(Not used - for future use). 


CTHPE - 3 






LDGDEV 


BDST 


The logical device nunber of the current extent of the disc log file or the 


The data segment nunber of this table. 


disc buffer file (buffer file has only 1 extent). 


LOGPIN 


BSPACE 


This is the PCB nunber for the logging process (PIN*PCBSIZE). 


The anount of space, in records, that art currently available to the users. 




On the last block of the last extent, one record will be saved by the logging 


MUHUSER 


process so that the proper close information can be posted to the file - 


The nunber of users currently accessing the logging file. 


either the trailer record (if the log logging process is stopped) or the 




change'to'neu record because of an EOF condition (and the AUTO option had 


nfiXUSER' 


been specified). 


The naxinun nunber of users allowed to access the logging file. 






BUFUSED 


USERNO 


The nunber of records currently in the buffer. On all extents, except the 


The next sequential nunber to be assigned users accessing the systen. It 


last extent BUFSPflCE+BUFUSED = 32 (number of records in a conplete block). 


Mill get increnented for every unique QPENL0& - used as the log 8 in the log- 


Houever, on the last block of the last extent this uill NOT be true since one 


ging record fornat. 


record is aluays held in reserve by the logging process. 


SLPCT 


VSETNO 


The nunber of users currently waiting for activation by the logging process. 


This shows the order in the log file "set" of the currently opened log file. 




(Not used - for future use). 


STATE 




The state of the user logging process. 


LOGADDR 


INACTIVE = 


The disc address of the current extent of the disc log file. If it's a 


ACTIVE = 1 


serial file, this is the disc address of the disc buffer for the file. 


use 


INBUFREC 


An internal nessage uord used to indicate an error or operator request. 


The record nunber of the next block to be written to the logging destination 


6 - Continue processing, all is fine. 


file or the disc logging buffer for serial files. (Used as an offset into 


2 - Suspend - error reading buffer file or writing to serial file 


the current extent for the writes - since each record is one sector in 


3 - Stop - set when issue :L0& logid,ST0P or when an EOF condition is 


length). 


found on the disc log file. 
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User Logging Buffer 


User Logging Buffer 


FSIZE 


TYPICAL LOGBUFF ENTRY 


The current extent size of the logging destination file or disc logging buff- 
er file for serial destination files, (on the last extent this uill be the 


# Z 


j | 


last extent size minus 1). 


L I 




I USER f 


FSPACE' 


I I 


The space in records that remains in the current extent of the disc logging 


I NAriE j 


destination file or disc buffer for tape destination files. (On the last ex- 


L J 


tent of the disc log file, this is the anount of space niruis 1). 
TRECS 


! I 
1 1 


4 1 |4 


The total nunber of records written to the logging destination file (includ- 


L J 


ing those records currently in the buffer). 


t GROUP | 

I i 


HAKFSPACE 


f NBHE "| 


The total file size, in records, minus 1. (Need that last record to post 


1 I 


close infomation). 
LBSTEXT' 


1 1 
E 1 


SI | 10 


The extent nunber of the final extent in the disc logging file or disc buffer 


L J 


file. 


I I 




| ACCOUNT | 


EXTENT 


I "I 


The current extent nunber of the disc logging file or disc logging buffer. 


l_ NAflE J 


RESOURCE 

Used for resource nanagenent (i.e. locking the LQGBUFF). Fornat is: 


f t 

i i 


12 1 USER PCB * | 14 


RESOURCE + - Owner PCB nunber 

RESOURCE + 1 = Head of impeded queue PCB nunber 


I I 


13 | OPEN LOS COUNT | 15 


RESOURCE + I = laii of impeded queue PCS nunber 
RESOURCE + 3 = Queue length 

UHEAD 


i i 


14 | UAIT STATE I 16 
I I 


15 | ERROR CODE I 17 


A table relative pointer to the first entry into the logging data segment. 
(-1 = no entries currently in use) 

FHEAD 


I I 


15 | LOG NUHBER I 20 
I I 


17 | SUBSYSTEB CODE 1 21 


A table relative pointer to the first free entry in the logging data segment. 
(-1 = no free entries) 


j | 


18 | TOTAL | 22 
j i 




f RECORDS "| 
I I 
I I 
I. -I 
I I 




I. -I 
I I 
I I 

23 I FRUO ENTRY PTR I 27 
I I 


24 | BKURD ENTRY PTR I 30 
I I 
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Ueer Logging luffer 


Ueer Logging luffer 








BIMOCK • BVTE INDEX TO CURRENT CHTRV 
IHOEK • UORO INCEK TO CUWtENT ENTRY 
OIHOEX • DOUBLE INDEX TO CURRENT ENTRV 


NENTRV 

R table relative pointer to the next entry in the logging data eegnent, (-1 • 

thie ie the laat entry) 


USER • 8IN0EX 
GROUP • 6INDEX*« 
RCCT • IINDEX»16 


PENTRV 

R table relative pointer to the 

(-1 ■ thie ie the firat entry) 


previoue entry in the logging data eegnent. 


UPIN • INOEX*12 
OPENCKT » INDEX*13 
USTRTE ■ INDEXtM 
ERROR • INDEX** 5 
LONUn • INDEK+1S 
SCOOE • INOEXtl? 








RECS • DINDEX+9 








NENTRV ■ INOEX«23 
PENTRY " INOEX»24 








USER 

The nane of thf ueer uho opened the logging file through thii entry. 

CROUP 

The group of the uter uho opened the logging file. 














RCCT 

The account of the ueer uho opened the logging file. 








UPIN 

The PCO minber of the ueer procett (PIN * PCBSIZE). 








OPENCNT 

Counter of hou nany tinee thie ueer called OPENLOG. (Increnented for every 

OPENLOG, decremented for every CLOSELOG). (Not ueed - for future uae). 








USTRTE 

The wit statue of the ueere proceee. 

INRCTWE «0 

ACTIVE « 1 








ERROR 

Ueed to hold error infometion for thie ueer. 

-1 ■ No roon in due (or diec buffer) and HOUIIT. 
■ O.K. 








IGHUH 
i The logging nunber aeeigned to the ueer. (Fron USERNO in global area to be 
ueed ae log tt in the log record). 








SCOOE 

The subeyuten code for the caller. Thie appliee only to privileged cellere. 

DECS 

The nunber of recorde uritten by thie ueer. 
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Logging Identifier Table 


Logging Identifier Table 






Ueer Lomine Identifier Table 


Typical Entry 






ENTRV SIZE ' »33 uorde 
DST 141 


1 






z 











6 


Table containing an entry for each potential logging proceee. Entriee are 
added via :GETLOG and releaaed via :RELLCG. 




LOGGING 
" IDENTIFIER 


. 






I Sntry W 


4 






4 














8 


PRSSUORD 


- 


10 





1 
2 

I 3 
4 





1 
2 
3 
4 


hRX NOWrt OF QtTtlES 






FILE 


- 


CWtftV SiZE 




32 




40 


1! 






14 














ENTRIES 




FILE 


~ 






HF.HTRIES ' LIDTDB(I) 
ENTRYSIZE ' LI0TR6(4) 




LOCK UORD 








NENTRIES 

The naxinun nunber of entriee in the table, (i.e. naxinun nunber of ueer log- 
ging proceeeee. 1 entry for every proceee - activated or not). 


16 






20 




FILE 


_ 


ENTRVSIZE 

The aize of each entry in the table. 


20 


GROUP 


■ 


24 












FILE 


- 










ACCOUNT 


- 


30 




» 
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Logging Identifier Table 


Logging Identifier Table 






Typical Entry (Cont. J 


The group that the file resides in. 






USER'S 
NAI1E 




FSCCT 

The account that the destination file resides in. 

UHAflE 

The nane of the user uho created the logging identifier. 




28 
32 




34 
40 


UBCCT 

The account of the user uho created the logging identifier. 

TYP 

The status of the entry. -1 = null entry 

- disc logging file 

1 = tape logging file 

2 = serial disc logging file 

3 = cartridge tape logging file 




USER'S 
ACCOUNT 


LOG TYPE 


BYTE ENTRIES 






UD = 6LIDTAS 
PU = BLIDTHBC8) 
FMflllE' = BUDTfl8(16) 
Ul = 6LIDTB8(24) 
FGROUP = BUDTBB(32) 
FflCCT = BLIDTBB(40) 
UNBHE = BLIDTBB(48) 
UBCCT = 8UDTA6(56) 






UORD ENTRIES 






TYP = LIDTBB02) 






LID 

The logging identifier nane. This is a naxinun of eight characters long. 






PU 

The pass uord for the logging identifier. This is a naxinun of eight charac- 
ters long. 






The following is the fully qualified file nane of the current log file. 






FHflllE' 

The nane of the destination file. 






Ul 

The lock uord on the destination file if the file is on disc. 






FGROUP 
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User Logging Record Fornats 




Loqqinq Record Fornat 


TRAILER RECORD (STOP) 




RECORD SIZE = 128 uords 
USER UREA = 119 uords 


2 3 4 6 7 11 


127 


I I I I I I I 
I recti! cksun | code |tine|date| logid | 
I I I I I I I 






LOG RECORD AT OPENLOS 

2 3 4 E 7 11 12 24 25 127 


NULL RECORD 

2 3 4 6 7 


12 






I I I I I I I I ! I 

recttlcksunlcode |tine[date| logid|log#| croatorlpcb t I 
I I I I I I I II I 






I I I I I I 
j rec#|cksun|code |tine|date| 
I I I I I I 






JSER OR SUBSYSTEhVCONTINUATION LOG RECORD (f ron URITELOG) 

) 2 3 4 6 7 8 9 127 


< 


BEGIN TRANSACTION MARKER 

2 3 46789 


12 






I I I I I I I I 

rec# I cksun | code |tine|date|logK |len| user area | 

I 1 I I I 1 1 1 






I I I I I I I I 

I recti cksun I code I tine I date I logs' lien I user area 

I I I I I I I I 








JIG RECORD AT CLOSELOG 

2 3 4 6 7 11 12 24 25 127 






END TRANSACTION BARKER 

2 3 4 6 7 8 9 


12 






1 1 1 1 1 1 1 II 1 
rec* 1 cksun I code |tine|date| logidllogKI creatorlpcb I 

1 1 1 1 1 1 1 II 1 




I I I I I I I I 

I recti I cksun I code I tine I date I logH I lent user area 

I I I I I I I I 












CRASH I1ARKER 






( 


2 3 4 6 7 127 


CODE DEFINITION 

CODE. (8:8) = 

1 Open log record 

2 User/subsysten record (uritelog) 

3 Close log record 

4 Header record 

5 Trailer record 

6 Restart record 

7 Continuation of a user or subsysten record 
9 Crash narker 

10 End transaction record 

11 Begin transaction record 
SPACE NULL record 






I I I I I I 
red* I cksun | code I tine I date I 

I I I I I I 


( 


1EA0ER RECORD (START/RESTART) 

2 3 4 6 7 11 127 




I I I I I I I 

recti I cksun I code I tine I date I loqid I i 

I I I I I I i 
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; 



Uttr Log|ln| Record Fonutt 



DATA FIELDS OF UK RECBIOS 



REC* 


DOUBLE INTEGER 


cksuii 


INTEGER 


CODE 


INTEGER 


TIDE 


DOUBLE (f rw intrintie CLOCK) 
INTESER (fro* intrintie CALENDAR) 


DATE 


LOOID 


ASCII 


loon 


INTEGER 


LED 


INTEGER 


USERAIEA 


ASCII 


CREATOR 


ASCII 


pcb 


INTEGER 



NOTE: 

1. Th* chtcktun algorithm uttt the exclutivt or (XOR) function againtt i baat 
of motive on*. 

2. Null racgrd it ut*d tar filltr. 

3. Th* cod* word of thf logging record can contain a tubtytttn cod* oefined 
by the u«r in th* firtt hilf of th* word (0:8). U«r logging allout 
privileged unit to pat* thit cod* in the index pertmter of the Openlog 
intrinsic. 

4. Th* "len" field uill contain th* mtire length of the data in th* trantee- 
tion (i.i. tht length patted to IMITELOG, BEGINLOG, ENDLOG). If a continua- 
tion record it part of the trantaction, it uill alto contain the *ntir* 
length of the data. For txanplt, a length of 140 Mat patted to tht intrintic. 
Th* "l*n" field of the firtt record uill be 140, the "ltn" fidd of it* con- 
tinuation record uill alto be 140 - even though the actual anount of data 
found in th* firtt record «ill be 110 and th* data found in the continuation 
record uill be 21. 

(Positive length * A uordt, negative length * N byte*) 
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niaturencnt Information Table 
NEASIKfOTAB 



03T • 69 (J 73) 



Reaarved 

for I1EASI0 
control 
! 

I 



I LOW * OF RCASIO 

1 I hEASIO PLABEL 

2 I mm ost * 

j r " 



HEASL0EV 
NEBSPUW 

HEASDSTN 



I 



4 I 

si 

e r 



I 10 I 

i 
i 11 1 



i 



I 12 I 
Rtterved ---- 
for 13 I 

ptrfomanct 

tuning 14 I 

paranttert 

I 15 I 



I 

I 15 I 

I 

I 17 I 



I 20 I GLOBAL STATISTICS KOS NUNBER 
I 



I 

i 81 I PROCESS STATISTICS XDS BANK 

I I 

I 22 I PROCESS STATISTICS XOS BASE 
I I 



NEASSTATX- 
DSKUft 



HEASPROC- 
KDSBANK 



nEASPROC- 
XOSBASE 



I 23 | PROCESS STATISTICS WIS RUBER 



flEASPROC- 
XOSNUn 



I 24 | CLASS 14 STATISTICS MS BANK | 
I 25 I CLASS 14 STATISTICS XOS BASE I 
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heaaureflcnt Information Table 



HEBSIHF0TA6 (Cent.) 



Niaturencnt Information Table 



N^ASpifOTAA (Con^,) 



26 1 


CUSS 14 STATISTICS XDS HUB. I 


27 1 


CUSS 13 STATISTICS XOS BANK | 


30 1 

si r 

32 I 


CUSS 13 STATISTICS XDS BASE i 
CUSS 13 STATISTICS XDS NUB. | 
CUSS 12 STATISTICS XDS BANK I 


33 I 


CUSS 12 STATISTICS XDS BASE I 


34 1 


CUSS 12 STATISTICS XDS Mil. I 


35 1 


CUSS 11 STATISTICS XDS BANK I 


36 1 


CLASS 11 STATISTICS XDS BASE I 


37 1 


CLASS 11 STATISTICS XDS NUB. I 


40 1 


CLASS 10 STATISTICS XDS BANK I 


41 1 


CUSS 10 STATISTICS XDS BASE I 


42 1 


CUSS 10 STATISTICS XDS NUN. I 


43 1 


CLASS 09 STATISTICS XDS BANK I 


44 I 


CLASS 09 STATISTICS XDS BASE I 


45 1 


CLASS 09 STATISTICS XDS NUN. I 



I 

rtterved 

for 

neaaurencnt 

intirface 



I CUSS ENABLED 
I COUNT 



I CLASS 1 ENABLED 
I COUNT 



I CLASS 5 EN.CNT. 
I CLASS 7 EN.CNT. 



I CUSS 6 EN.CNT. 

I CLASS 8 EN.CNT. I CUSS 9 EN.CNT. 



51 I CUSS 2 EN.CNT. I CLASS 3 EN.CNT 

52 I CUSS 4 EN.CNT 
53 
54 
55 
56 

I 57 | CUSS 14 EN.CNT 
I 60| 



I CUSS 10 EN.CNT. | CUSS 11 EN.CNT. 
i CUSS 12 EN.CNT. 



I CUSS 13 EN.CNT. 
I CUSS 15 EN.CNT. 



I 

I 61 
r*t*rv«d 

for 62 
tht red 
clock 63 
intirf act 
uttr 64 
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tleasurenent Infornation Table 



REflSINFOTRB (Cont.) 



1 70 
1 
shared 71 

clock 72 

interface 73 

cells 74 






n 1 FUG 


1 n 1 


XDSI 




XDS2 




OCOUNT 




D LIBIT 






75 
76 
77 
100 
101 
102 


TCOUNT 






Tann 






OLRBEL 






NONITOR BUFFER INDEX 


I SBONIDX 




HERS BUFFER 


I BERSBUFO 




BERS BUFFER INDEX 


I I1EASIDX 


reserve 


i 103 


BERS ENRBLED FLAGS 


! HEASBSKO 


event 104 


BERS ENABLED FLAGS 


I WRSBSK1 




105 


BERS BUFFER BANK 


1 IIERSBUFBflNK 




106 

116 
117 







































II: Interrupt has Hissed due to last interrupt handling. 
A; Current interrupt handling active. 
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nessage Filc» 



CHAPTER 18 nCSSflGE FILES 



flessaqe File Data Structures 



This chapter contains the data structures necessary to support nessage files. 
The first section details the nessage file's version of the faniliar file 
systen data structure; ie, the file label, file control block, access control 
block, etc.. 

The second section shows the tables used by the basic IPC riechanisn which is 
a set of internal, UPE procedures designed to support the "boundary condi- 
tions" of IPC files. For exartple, signaling a no wait reader that its record 
has arrived. See the section's introduction for a detailed description. 

File Structure 



File Labei/FCB Extent nap 



I Disc addr of extent 
| 

I Disc addr of extent 1 



End of file block Start of file block 



I 



j Disc addr of extent 2 I 

I I 

I Disc addr of extent 3 I 
| 1 

\ 

I 

| Disc addr of extent n-1 
| 

| Disc addr of extent n 



I- 



The EOF and SOF are exanples only, neant to show: 

1) The start of file noves into the extent nap as records are read 

2) The file can urap around and, hence, cause the SOF to be greater than the 
EOF. 

Uhen a file becoties enpty the SOF and EOF are reset to the first block of ex- 
tent zero. 

Each extent is conposed of a nunber of blocks. Extents all have the sane 
nunber of blocks. Extent zero also contains space for the file label and 
user labels in the exact sane fornat as standard files. Starting uith block 
zero, sufficient blocks are allocated to the file label/user labels to satis- 
fy their space requirements. 

Extents outside of the SOF/EOF range nay not exist. They are deleted at 
close tine when there are no nore writers accessing the file. 
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Dessage Files 



LUock Structure 



| First data record 
I- 



| Second data record 

I 

\ 

I 

I Last data record 
I- 



Record delimiter (-1) 



Enpty space (next record 
uould not fit) 



Header deliniter (Z7?) 



I Last header record 



****** ******************** ******** 



Exact sane fornat as standard 
variable length blocks. 



A***********************?!*******.** 



Second header record 



First header record 



Separating the data portion of the records fron their header enables the 
standard file systen access procedures to read the records with no knowledge 
that they are nsg file records. 



| Nunber of bytes in record j 
I 1 

i First data word of record | 

, , 

i i 

I Last data word of record I 
| 1 

Length word's value does not include itself. 
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nessage Files 



| 

I CILCI 



I- 

I Writer's ID 



I- 

C (0:1) 



I Header Type I 
I -1 



■ Set on if this was the last record written before 
the systen crashed. This bit is set on by the 
first open on the file after the crash. 



LC (1:1)- Valid only for close headers. Set to one if this is 
the last writer to close the file. 

Type(S:8)- data 

1 open 

2 close 

nessage Recess Control Slock 

Notes: 

1. words/fields that do not pertain to nessage files are left 
blank. 

2. This diagrari shows the "contained" flCB as it appears to 
the nessage access procedures (the procedures in IPC). 
Thus it is a conbinatian of the LfiCB and the PflCB. 



-5 I DST nunber of the PflCB 



1-5 



-A | PflCB control block vector table address 
I 

-3 I DST nunber of the LFICB 



1-3 
-I 
1-2 



-1 I 



j I Size of the flCB including buffers (words) I 
I - - I 

1 I File Nunber I 1 



2 I File nane 
I 

\ 



I- 



6 I Foptions 

I • 

7 I Hoptions 

I 



I 6 * 
-I 
I 7 * 
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flessage Files 

nessage Access Control Block (Cont.) 



8 


Record size (bytes) 


10 * 


9 


Block size (words) 


11 * 


10 




12 


11 


Carriage control code (uriters) 


13* 


12 


Mo wait I/O target 


14 * 


13 


Ho wait 1/0 count 


15 


14 


Error code 


16* 


15 


Transnission log (units sane as last 


read/write) 


17* 


16 


Total nunber of unread records (includes opens 


20 


17 


and closes) 


21 


18 


Block nunber of the file's tail (relative to the 


22 


19 


start of file block) 


23 


20 


Logical record transfer count 




24 


21 




■>c 


22 


Physical block transfer count 


26 


23 




27 


24 


DST PEL ADDR of Read Header 


30 


25 


DST REL ADDR of Urite header 


31 


26 


FCB DST 


32 


27 


FC8 vector table offset 


33 


28 


Share count ( nunber of LAC8s ) 


34 


29 


Access class, status, etc. 


35 


30 


Logical device nunber 


36 


31 


lUrt buf indxl 


1 It buf - 1 


37 


32 


DST relative address of next read record 


40 


33 


Size of the buffer (words) 


41 
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""'"■ "ccest Cwnnil Mack (Cant. \ 



Spirt 



fBWT indtx 



Nufibtr of n<d UCBl 



Typt and disposition 



Recess ruwk 



I Records ptr block 



0|tt rt buf I * ut buf |ir |qu In |e Id It If 



flitc. ms fill flags 



Hunter of frtt uord in tht currtnt frte record 



Nunber of fret rtcordt 



Nunber of nondata rtcordt in the fill 



Spare 



ttopen rtcordt 



! » read requests 



last read error | last write error 



DST relative addrese of the next urite record 
Spare 



Spare 



DST rel address of the PBCB 



DST rel address of the LflCB 



DST relative address of the stack ACS 



55 I Stack DST relative address of 06 



I- 



56 I Target area's DST nunber 



I- 



57 j Reserved for calling paraneters 

5S | 

| 

59 I 
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netaage Files 



Message Itecess Control Block (Cont.l 



78 I Head record's uriter ID 



79 I Hire, flags 



I- 



I Record type 



80 j Size of record + count + header words 



I- 



81 | Conpletor ID 



I- 



I Uaiter ID 



82 | Local flags 



I- 



83 | Target DST nunber 



I- 



84 | DST relative address of target »na 



85 | Length of target area 



I- 



86 I Uaittr's reply port, if using HCB conpltn area 

87 I Uaiting process's PIN 



88 I Uaiting process's' pin 



89 | waiter's soft interrupt plabel 



90 I Resultant error code 



I- 



91 I Resultant transnission log 



I- 



92 I DST rel address of first buffer 



I DST rel address of buffer tuo 



120 
121 
122 
123 
124 
125 
126 
127 
130 
131 
132 
133 
134 



* Value it private to a particular accessor. 
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llttiagi Filn 

ftoillM Becilt Control Block (Cent. 



Retervtd for tht ttack narktr fron fiit tytttti 
intrintiet 



\ 



\ 



Ustr't toft interrupt plabtl 



Hunbtr of seconds to uait on boundary condition 



OIEx|Md|Vr|Bt|Cls |C I Carriage control 



Reply Port (basic IPC port) 



Uriter ID 



Control block index for nouait urittr record buf 



DST rtlativt addr of nouait urittr record bufftr 



No uait I/O resultant trror code 



No uait I/O resultant transnission log 



urite uait queue (basic IPC port) 



75 Read uait queue (basic IPC port) 



76 I Length of record in bytes 



77 I Head record's record type (sane values as header)! 
I - I 



74 
75 

100* 

101 « 

102« 

103* 

104* 

105* 

106* 

107* 

110* 

111 

112 

113 

114 

115 
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Message files 



Uord Field Description 



(0:1) 

(1:1) 
(2:1) 
(3:1) 

(4:1) 

(5:1) 

(6:1) 



Accessor' s local flags. 

1 - have not yet issued an FRERO/FURITE against 

the file, 
ex 1 - extended uait node, 
nd 1 - do not destroy the next record read, 
vr 1 - uriter has not yet uritten his first record 

(ie. , he it a virgin), 
bt - transnission log should be expressed in words. 
1 - " " " " " " bytes. 

clt - Not currently used (reserved for group IPC 

standard). 
. . C - No uait completion nessage is in LHCB area. 
(8:8) car ctl- carriage control character to be used for 

the uriter's record (a value of one indicates no 

carriage control character). 

File's global flags. 

(1:4) - nunber of read buffers 

(5:4) - nunber of urite buffers 

(9:1) er 1 - extended read 

(10:1) qu 1 - one or nore writers has been queued on the 

uait queue. 
(11:1) n 1 - uait nsg is located in the fiCB 

(12:1) c 1 - conpletion nsg is located in the HCB 

(13:1) d 1 - the current urite buffer has dirty bit set 

(14:1) s 1 - the start of file is block zero 

(15:1) f - the FICB buffers have not been filled 
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H«SiJ9« Filet 



Octal 
Value 


Event Type 


Paraneter 1 




Paraneter 2 


72/0 


Read init 


# free rec 






72/1 


Read conpl 


(0:8) error, 


(8:8) ID 


Nunber of records 


72/2 


Urite init 


(0:8) * rec, 


(8:8) ID 


Nunber of free records 


72/3 


Urite conpl (0:8) error, 


(8:8) ID 


Nunber of free records 


72/4 


Control 


(0:8) error, 


(8:8) ID 


(0:4) func, (4:12) parn 


72/5 


EOF 


(0:8) error, 


(8:8) ID 


Nunber of records 


72/6 


Open 


(0:8) error, 


(8:8) ID 


Nunber of records 


72/7 


Close 


(8:8) Kfree, 


(8:8) ID 


Nunber of records 


72/10 


Initiation 







(0:8) fix, (8:8) update 


73/0 
73/1 
73/2 


Put record 
Delete rec 
Delete blfc 


(0:8) error, (8:8) 10 
(0:8) error, (8:8) ID 
Start of file block » 


(0:3) rec type, 

(3:13) nunber of records 

(0:3) rec type 

(3:13) nunber of records 

End of file block • 



1. The aa/bb notation in the "octal value" coluim denotes type/subtype. Type 
is the actual IWSTRT event nunber. Subtype is (0|4) of paraneter 0. 

2. Several itens can possibly exceed their fields, in that case the bits 
beyond the field are lost. These itens are nunber of records, nunber of free 
records, start of file, and end of file. 
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ilfssigt Files 



3. Paraneter uord zero has a conrton fomat for all the HflSTBT events. 



Field 
(0:4) 
(4:2) 



(6:1) 
(7:1) 
(11:1) 
(12:4) 



Description 



Event's subtype. 

File's state 

- enpty 

1 - partially full 

Z - only a fraction of a free record is left 
3 - conpletely full 

Nonzero indicates that there is one or nore 
waiting readers. 

Nonzero indicates that there is one or nore 
uaiting writers. 

Nonzero indicates that the urite has a carriage 
control character. 

Flags local to the accessor. 

(12:1) - the accessor has done no FREAOs/FURITEs 

(13:1) - extended wait 

(14:1) - nondestructive read 

(15:1) - writer has not uritten any records 
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File Systen Basic IPC Definitions 



The objective of this set of uncallable procedures is to provide a sinpie ipc 
nechanisn to support the ipc file access procedures. It enables one process 
to send short, control nessages to another process. 

General Behavior 

FCPORTDPEN Procedure 

The heart of this nechanisn is the port. R process desiring to receive nes- 
sages would first open (create) a port. This process is temed the "port 
nanager." Uhen the port is created, a port nunber is returned to the opener. 
Since the port nunber value cannot be known in advance, potential senders 
need sane Method of obtaining the port nunber fron the port nanager. 

Both the ports and the nessages are contained in a single disc resident data 
segnent. There can be a total of over thiry-five hundred open ports and out- 
standing nessages Thus neither ports nor nessage blocks are scarce 
resources. 



FCPORTSEND Procedure 

This procedure sends a to 5 uord nessage to a port. Optionally a tineout 
value nay be specified which uill Unit the duration the nessage will renain 
attached to the port. Expiration of the tineout causes the nessage to be 
deleted fron the target port's queue and placed on the sender's reply port 
(specified by the sender in the FCPORTSEND procedure call), 

FCPORTRECEIVE 

Reads and deletes the head nessage fron a port. The sender's return port 
nunber is also given to the receiver, enabling hin to send a reply nessage. 

FCP0RTCU3SE 

Denolishes the port. 

IPC file's use of this nechanisn 

Rll open nessage files have tuo ports open for the file (read wait queue and 
urite Halt queue), plus one port per accessor (reply port). Their use is 
described in the following. 



Nessage Files 



Reader and writer uait queues 

Uhen an enpty nessage file is accessed by nore than one reader (share), then 
there nust be a uay of having the readers' FREROs satisfied in the sane order 
that they were issued. That is, there nust be queue of uaiting readers. The 
ipc access procedures acconplish this by dedicating a basic ipc port as a 
"read uait queue." Whenever a reader's request is stalled because the file 
is enpty, a nessage is sent to the read uait queue. Subsequent FRERDs by 
other processes uill queue up behind the first reader in a FIFO nanner. Rn 
FURITE uill take the first entry fron the uait queue and send a "read nay be 
done" nessage to the reader's reply port. 

In a like nanner nultiple writers uill queue on the urite uait queue uhen the 
file is full. 

Conpletion notification for nouait I/O 

The IOURIT intrinsic uaits for a nessage to be sent to the reply port (s) of 
the specified user files. 

Tineouts 

Uhen an accessor encounters a boundary condition (ex, a reader accesses an 
enpty file), it nay specify that the condition nust be satisfied in x seconds 
(FCONTROL 4). To this end the ipc access procedures nerely issue the 
FCPORTSEND to the uait queue uith the user's tineout value specified. The 
tineout uill tear the nessage fron the uait queue and place it on the acces- 
sor's reply port. 
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Port Dlti Structure 
Port Data Stgntnt 



Syttin DB txtmion (Port DST «| ■ 
+ X100 



Port dit« ■igtwnt 



Global arta 


Rwaindtr it 

cotipottd of 
"block »iie" 
chunk*. 



Tlit chunki irt a combination of fret entries, port>, ntssagt qotut 
■ntries, and tintr liet tntrits. 



Port Uith Two Outstanding Messages 



I Port 



I IWE 1 



I- >| 

! I HOE Z 

I I 
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Port Data Stgntnt Global Area 



1 


Data stgntnt nunbtr of thit port data stgntnt 


1 I Block ai2t in uorda 


2 I 


Total nunbtr of blocks 


3 I 


naxinun nunbtr of blocka 


1 i 


Currant nunbtr of frtt blocka 


5 1 


Nunbtr of open porta 


6 1 


Hud of free list 


7 1 


Tail of free list 


10 I 


Head of inpeded process list 


11 I 


Tail of inpeded process list 


12 I 


Head of tineout thread (TOE address) 


13 1 


TP.LX of tineout 


14 I 


Value returned by TWER intrinsic (then 


15 I 


Tineout uas initiated. 


16 I 


Head of port list (in units of port nunbers). 


17 I 


Hot used. 



2 

3 
4 

5 

i 6 
I 

I 7 
I 

I 8 
I 

I 9 
I 

I 10 
I 

I 11 
I 
I 12 

13 

14 

15 
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Port Nunbtr 



1 2 3 4 5 e 7 > 9 10 11 12 13 14 15 16 

IPort lndtx I Port data stgntnt relative tddr/8 I 



-I 



Port index Index into the port DST nunbtr array 



Port DST Nunbtr Array 
Located in Sytttn DB Extension Urea. 



64 I Port/data stgntnt nunbtr 



65 I Rtttrvtd for a atcond port stgntnt 
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Message Files 
Port 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

---I--I-H--I-I-I-I-I--I--I-I-I-I--I--I— 

I Head IWE address | 



1 I Tail HOE address 



I 1 



2 IE I U | Next port nunbtr in port list threadl 2 



3 II ISubtypelPort Pin nunbtr 

4 I Soft interrupt parantter one 



5 I Hunter of HBEs in the port's queue 

6 I Nunber of sends to this port 



7 | Soft interrupt p label 

8 | PIH of port's ouner 



I 3 
I 4 
I 5 
I 6 
I 7 
I 10 



10 II |2 |3 |4 15 |6 |7 |8 |9 |10|11|12|13|H|15| 

E Enable uake up bit 

- Do not auaken the process 

1 - Auaken the process 

U type Action to be taken on an enabled port uhen a nessage is 
received. 

- Auaken the process on a nessage uait bit. 

1 - Generate user software interrupt 

2 - Generate systen softuare interrupt 
I Interrupt node. 

Subtype Soft interrupt subtype 
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flessage Files 
flessage Queue Entry (nQE) 

1 2 3 4 S 6 7 8 9 10 11 12 13 14 15 16 

I Next m entry; if last, (port addr) LOR 7 I 

1 I Port number of return port I 1 

2 ITine List Entry (TLE),0=no tineout, -1'timed outl 2 

3 I Parameter zero t 3 

4 I Paraneter one j 4 

5 I Parameter tuo I S 

6 I Paraneter three I 6 

7 I Paraneter four ! 7 
|0 |1 |2 13 |4 |S |6 |7 IS '\S |10|11|12|13|14|15l 

Tiner entry definitions - - no tineout 

1 - tineout expired 

2 - TIE address for a pending tineout 

file System flessage Files 

Uait flessage 

pamtt 

- URITER ID 

1 - LOCRL FLAGS (differ uith each accessor) 

(0:1) - accessor just opened file 

(1:1) - Hill uait on boundary condition if no symbiotic process 

(3:1) - writer has not written a record 

(4:1) - transmission log in bytes 

(8:1) - carriage control code 

2 - DSTIt of data buffer 

3 - Rddress of data buffer (DST relative) 

4 - Length of data buffer in bytes 

Completion flessage 

- Resultant error code 

1 - Resultant transnission log in bytes 
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Timer List Entry (TIE) 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

— |..|-|-|«|~|"l"l"l--l"l"i"l~i-l — 
I Next TIE (sorted in incr tine val), if last I 



I 1 

I 2 

"l 3 



1 I Preceding TLE entry (0 if first entry) 

2 I Number of milliseconds the tineout value 

3 I of this TLE is beyond the previous TLE. 

4 | Rddress of the affected ME I 4 

5 i Rddress of the HOE'S port I 5 

6 I Value of TIBER uhen this tineout expires I 5 

7 I billiseconds) I 7 
10 |1 12 13 14 15 16 17 18 19 |10|11 |12|13|14|1S| 



fltlSTftT Definitions 








Octal 
Value 


Event Type 


Paraneter 


Paraneter 1 


Paraneter Z 


62 


Open 


Port nunber 


Port DST nun 


Flags paraneter 


63 


Receive 
completion 


Port nunber 


tlQE address 
15:1 Uaitspc 


Return port 


64 


Send 


Port nunber 


HGE address 
15:1 Q type 


Return port 


65 


Change 
status 


Port nunber 


= enable 

1 = disable 


Head HOE 
address 


66 


Abort 


Port nunber 


Paraneter 
zero 


Return port 


67 


Close 


Port nunber 


Port OST 


* open 
ports left 


70 


Expand 


Port DST nun 


# expand blks 


Total * 
blocks 


71 


Tineout 

expired 


Port nun 


IWE address 

G.01 .00 
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CHRPTER 19 HPE HEHQRV RESIDENT HESSAGE FACILITY 



Overview of Facility 

The nenory resident Message facility of HPE V addresses the need for an effi- 
cient, sinpie, and uniforn nethod for systen code to tend short status-type 
Hcesages to processes. 

Each process is created uith a "port" in the Message harbor table (DST X71) 
which supports a set of nessage subqueucc which are private to that process. 
There is a naxinun of four subqueues per port in the initial inplenentation. 
This Unit can be easily extended uhen new subqueues are required. 

Any systen code, even code running on the ICS, can send a Message to any sub- 
queue cf any process. The destination process 1 PIN mist be known, any a 
priori conventions on subqueue nunber and Message fornats mist be es- 
tablished. The caller of SENDMSG nay optionally specify that the destination 
process be auakended fron a nessage wait. 

Message can be any length up to the configured naxinun. Hessage length is 
specified in the call to SEHDHSG and RECEIVEHSG. In the initial inplenenta- 
tion, nessages are United to 8 words in length uith 4 uords available for 
data. This naxinun can easily be increased if the need arises. 

By calling PORTSTRTUS, a process nay at any tine deternine whether a 
specified subqueue is non-enpty or obtain the subqueue nunber of the nost ur- 
gent non-enpty subqueue (lowest nunbered one). 

By calling RECEIVEHSG, a process nay receive the nessage at the head of the 
specified subqueue. This receive is optionally non-destructive. 

fi process can wait on a nessage wait, or on a conbination of nessage wait and 
other uait types. 



Hessage Intrinsics 



Procedure SENDHSG( Destpin, Subqueue, ".eg Length, Flags); 
Value Destpin, Subqueue, HsgLength, Flags; 

Integer Destpin, Subqueue, HsgLength; 

Logical Flags; 

Option Privileged, Uncallable; 

Destpin, Subqueue, and HsgLength have to be uithin range or a Systen Failure 
622 will occur. 

The caller of SENDHSG stacks the nessage contents before calling the proce- 
dure. SENDHSG expects the first nsg word to be at Q-7-HsgLength, and the 
last nsg word at Q-8. The nessage contents at Q-8 to Q-VtlsgLength are 
deleted fron the top of stack by the exit fron SENDHSG to the caller. 



6.01.00 
19- 1 



Henory Resident nessage Facility 

Flags. (1:1) * 1 "> Uake-up destination process fron a nessage uait. 
Return CC ■ CC6 if process uas already awake else CC ■ CCE. 

PORTSTRTUS 

Logical Procedure PORTSTfiTUS(Subqueue); 
Value Subqueue; 

Integer Subqueue; 

Option Privileged, Uncallable; 

Uhen supplied a valid subqueue nunber, PORTSTRTUS returns a true value if the 
subqueue is non-enpty and a false value if the subqueue is enpty. 

Uhen passed a -1 a subqueue paraneter, PORTSTRTUS returns the subqueue nunber 
of the process' nost urgent non-enpty subqueue (the snaller the nunber, the 
nore urgent the subqueue). 

If all subqueues are enpty, PORTSTRTUS returns CC - CCE. If at least one 
subqueue is non-enpty, PORTSTRTUS returns CC ~ CCG. 

RECEIVEHSG 

Procedure RECEIVEHSGtSubqueue, HsgLength, Flags); 
Value Subqueue, HsgLength, Flags; 

Integer Subqueue, HsgLength; 

Logical Flags; 

Option Privileged, Uncallable; 

Subqueue and HsgLength has better be uithin range or a Systen Failure 622 
will occur. 

The caller of RECEIVEHSG does an RSSEHBLEfflODS HsgLength) to nake space for 
the nessage contents. RECEIVEHSG stores the nessage contents into Q-8, 
Q-9,...,Q-7-HsgLength. Q-7-Hsg Length contains the first uord of the nessage. 

Flags. (0:1) ==> do not release nessage fron head of subqueue (non destructive 
read). 

Return CC = CCG if all subqueues were enpty, else CC = CCE. 

I 0| 11 21 31 4| 51 61 
+—+—*—+—+—+ — 4 — + 

| LSI L| DRTR | LS » Subqueue or Link 

+--+_-+ + i = Length (2-6) 
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Supporting Data Structures 
Hessage Harbor Table [DST #57 (271)1 



| DST Index Nunber (X71) | 
+ + 

1 | Data Segnent Size | 

4 4 

2 I Reserved j 
4 4 

3 | Haxinun nunber of PINS ♦ 1 | 
+ + 

4 | Haxinun Hsg Size (6) I 
+ 4 

5 | Reserved I 

t 4 

6 j Hessage Pool Head Painter | 
+ + 

7 | Hessage Pool Tail Painter | 
+ + 

8 | Available nsg Franes Count | 



9 | Head of inpeded queue I 

+ + 

10 I Tail of inpeded queue | 

+ + 

11 | Reserved | 
I I 

+ 4 

13 i Ports (IS uortis each) [ 
j (8 for header + 2 link uords j 
j for each of 5 subqueues) j 
* — + 

I Hessages (6 words each) | 

j (2 for header + 4 for data) I 
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CHAPTER 2C 


S1STBTS EVENTS 










nnsTRis 


Catalog Index 






EVENT NBHE 


EVENT NO. 




EVENT NflllE 


EVENT NO. 




DEC. 


I 






DEC. 


% 


RIXSTBUt 


20 


024 (-) 


* 


FREBD 


62 


076 (-) 


BLLOCIlEtl 


12 


014 


* 


FREHDDIR 


64 


100 (-) 


UNREAD 


233 


351 (-) 


* 


FREADLABEL 


76 


114 (-) 


BREBK 


237 


365 (-) 


* 


FREADSEEK 


63 


104 (-) 


C ABSENT 


139 


213 


* 








CBBORTIO 


142 


216 


* 


FRENAHE 


80 


120 (-) 


CBCHE1IOV 


14 


016 


* 








CCUJSE 


146 


222 


* 


FSETIWDE 


72 


110 (-) 


CCLOSETRACEFILE 


154 


232 


A 


FSPACE 


69 


105 (-) 


CCONTROL 


152 


230 


* 


FUN LOCK 


79 


117 (-) 


CDT ATT 


se 


126 


* 








CGARBAGE 


7 


007 


* 


FUPOATE 


66 


102 (-) 


CONFIG-INFO 


221 


335 (-) 


* 


FURITE 


63 


077 (-) 


CONFI6-INF0 


222 


336 (-) 


* 


FURITEDIR 


65 


101 (-) 


CONFIG-INFO 


223 


337 (-) 


* 


FURITELRBEL 


77 


115 (-) 


COPEN 


140 


214 


* 


GIPINTERRUPT 


192 


300 








* 


GET COT 


15 


017 


COPENTRACEFILE 


153 


231 


* 


IOBUFTRRP 


125 


175 


CPOLLIST 


155 


233 


* 


I/O COMPLETION 


111 


157 (-) 








* 


INITIATE 


84 


124 


CREBD 


147 


223 


* 


IOUBIT 


67 


103 (-) 








* 


LINK REG 


89 


131 


CREBOI 


147 


240 


* 


tlAKEOC 


1 


001 








* 


MP Don 


87 


127 


CSDRIVER 


150 


226 


* 


nONINIT 


228 


344 (-) 


CSIDUBIT 


144 


220 


* 


nONOFF 


229 


345 (-) 


CURITE 


149 


225 


* 


PROCESS COHPLETE 


211 


323 (-) 


DC1EIC2RCK 


231 


347 (-) 


* 


QONSEC- 





000 








* 


QUE LDR 


16 


020 


DEALLOCH 


13 


015 


* 


OUIESCE 


40 


050 


0EALCST6LK 


21 


025 (-) 


* 


RELRESOURCES 


23 


027 (-) 








* 


REQCACHE 


90 


132 


OISKBUGCBTCHER 


200 


310 


* 


SEGIOINIT 


5 


005 








* 


SIODH-ENTRY 


194 


302 


DISKBUGCRTCHER 


201 


311 


A 


SIODB 


195 


303 


DISKERROR 


100 


144 (-) 


* 


SIODONE 


6 


006 








* 


SOFT' DEATH 


120 


170 


DISKERROR 


101 


145 (-) 


* 


SPECCHAR 


236 


354 (-) 


DISKINTRPT 


191 


277 


* 


SPECIALRQ 


2 


002 


DIIUE LOR 


17 


021 


* 














* 


SPECREAD 


238 


356 (-) 








* 


START I/O 


193 


301 








i 


STRATEGY 


83 


123 
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HHSTAT CATALOG INDEX 



EVENT 
GROUP 


DESCRIPTION 
OF GROUP 


PBGE 
NO. 





HENDRY IMNIKR 


20-1 


1 


(1EB0RV HANAGER/CACHING 


20-9 


2 


HEITORV IlflNAGER 


20-10 


4 


SCHEDULING 


20-13 


6 


FILE SYS 


20-16 


7 


FILESYS 


20-25 


8 


FILESYS/CACHING 


20-30 


9 


DISC I/O TRANSFER/CBCHING 


20-31 


10 


DISC ERRORS 


20-32 


11 


SIO 


20-33 


12 


DISC SPBCE 


20-34 


13 


DISC CACHING 


20-51 


14 


CS/3000 


20-36 


15 


CS/3000 


20-40 


16 


CS/3000 


20-43 


19 


DISC CONTROLLER INTRPT 


20-44 


20 


PRIVATE VOLUBES 


20-47 


21 


PROCESS CREATION AND TERMINATION 


20-48 


22 


OONITOR CONFIG IKFORHBTION 


20-49 


23 


TERI1INAL I/O 


20-53 



nnSTBTS Events 














DISK TRAFFIC 


98 


1« (") 


* 


SUAPIN 


8 


010 


FCHECK 


74 


112 (-) 


* 


SYSPINS 


224 


340 (-) 


FCLOSE 


81 


121 (-) 


* 


SYSPINS 


225 


341 (-) 


FCONTROL 


71 


107 (-) 


* 


SYSPINS 


226 


342 (-) 


FETCHSEG 


4 


004 


* 


SYSPINS 


227 


343 (-) 


FGETINFO 


76 


113 (-) 


* 


TERI1L0G0FF 


235 


353 (-) 


FIND DE 


18 


022 


* 








FLOCK 


78 


116 (-! 


* 


TERH LOGON 


234 


352 (-) 


FOPEN/(DA) 


60 


074 (-) 


* 


TERBREBD 


230 


346 (-) 


FOPEN/(DB) 


61 


075 (-) 


* 


TERHURITE 


232 


350 (-) 


FPOINT 


70 


106 (-) 


± 


UN HAP RG 


88 


130 
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ntlSTRT Event Group (nanorv Banaqenent Events) 



EVENT NAME: OONSEG 

DESCRIPTION: ABSENCE TRAP ON CODE/DATA SEGHENT 



CALLING HODULE: KERNELC 

CALLING PROCEDURE^!: 0UEUE0NSEGI1ENT 



PRRBBETER DESCRIPTION 
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P1.P2 = Segment Identifier 

P1.(0:4) = Segiient type field 

=> Data Segnent 

1 => SL Segment 

2 => Program Segnent 

3 => Cache Domain 

P1.(4:12) = Program index into CSTBLK (type 2 only) 

P2 = Segnent Number 

P3 = SLL Pointer (SLL table relative) 
P4 = STATUS (in stack marker) of calling (trapping) segnent 
P5.P6 - Unused. 
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janU 



EVENT NRI1E: nftKEOC 

DESCRIPTION: HAKE SEGT1ENT RN OVERLAY CANDIDATE - RELEASE SEGMENT 
TO THE POOL OF RVP.ILABLE SPACE 

CRUJN0 DOODLE: KERNELC 
CALLING PROCEDURE: IWKEOC 

PnRRhETER DESCRIPTION 



Pl.ra ' Segnent Identifier 

PI. (0:4) • Stgnint tm field 

■> Data Segnent 

1 ■> SL Signint 

2 ■> Proj''*" Segnent 

3 •> Cache Donain 

PI. (4:12) • Progran indsx into CSTBLK (type 2 only) 
P2 • Segnent Nunber 



P3 ■ Sink of region 
P4 ' Address of region 

P5.P6 - Unuwd, 
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Event 4 

EVENT NBnE: FETCHSEG 

DESCRIPTION: SEGHENT REOUEST (FOR I/O SYSTHI OR PROCESS) 

CULLING NODULE: KERNELC 
CULLING PROCEDURE: FETCHSEGHENT 

PARAMETER DESCRIPTION 



P1.P2 = Segment Identifier 

P1.(0:4) = Segnent type field 

=> Data Segnent 

1 => SL Segnent 

2 => Progran Segnent 

3 => Cache Oonain 

PI. (4:12) - Progran index into CSTBLK (type 2 only) 



P2 



' Segnent Nunber 



P3 ■ Requester ID 

.(0:1) = 1 => I/O System request 

.(1:15) = Ldev It 
.(0:1) =0 => Process request 

.(1:15) * Pin N of requesting process 

.(1:1) = 1 => IOFREEZE REOUEST 

.(2:1) = 1 => BLOCKED LOCK REOUEST 

.(3:1) = 1 => LOCK REQUEST 

.(4:1) = 1 => FREEZE REQUEST 



.(13:3)= 

= 1 
= 2 



P5.P6 - Unused. 



=> Segnent already present 

=> Segnent is Recover Overlay Candidate 

=> Segnent already on its way in for soneone 

(Segnent In notion In) 
=> Segnent not present — nust fetch 

(Full fetch) 
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Event 2 



EVENT NAtlE: SPECIALRQ 

DESCRIPTION: REQUEST OF SEGNENT EXPANSION/CONTRACTION, UNLOCK, 
UNFREEZE, IOUNFREEZE, LOCK, IOFREEZE, FREEZE 

CALLING MODULE: KERNELC, KERNELD, ININ 

CALLING PROCEDURES: UNLOCKSEG' , IOFREEZE', FETCHSEOTIENT-(KERNELC) 
DLSIZE, ZSIZE, GETPXSEG, RLTDSEGSIZE, 
ALTPXFILESIZE -(KERNELD) 

STRCKOVERFLW -(ININ) 

PARAMETER DESCRIPTION 



PI, K! ■ Stgnint Identifier 

P1.(0:4) • Stgnint type flild 

■> Wtt Segnent 

1 •> SL Segnent 

2 «> Progran Segnent 

3 ■> Cache Oonain 

PI. (4:12) • Progran index into CSTBLK (type 2 only) 
P2 • Sagntnt Nunber 



P3 ■ .(0:1) 

.(12:4) 



•1 •> Request is through FETCHSEGHENT 
(types 0,1,2) 
Type of request 

■ 0-> IOFREEZE 

■ 1«> FREEZE 

> 2» LOCK 

■ 3«> IOUNFREEZE 

■ 4»> UNFREEZE 

• S«> UNLOCK 

• 6» DLSIZE EXPANSION 

* ?■> DLSIZE CONTRRCTION 
= S=> PXFIXED EXPANSION 
= S*> PXFILE EXPANSION 

= 10«> PXFILE CONTRRCTION 

> 11» XDS EXPANSION 

■ 12=> XDS CONTRACTION 

* 13=> ZSIZE EXPANSION 

= 14=> ZSIZE CONTRRCTION 
« 1S=> STACKOVERFLOil 



P4 = For types (P3.(12:4)) 

« 0,2,3,5 => P4.(8:8) ■ LOCK OR IOFREEZE COUNT 

» 1,4 «> P4.(0:S) • FREEZE COUNT 

- 6-15 -> REQUESTED SIZE OF AREA IN UORDS 



P5.P6 - Unused. 
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EVENT NBNE: SEGIO 

DESCRIPTION: PIEnOSV nANBGEHENT REAO/URITE Of SEGNENT FRON/TO 
DISC QUEUED 

CULLING nODULE: KERNELC 

CRLUNG PROCEDURES: PROCESSINITHSG, STBRTSEGURITE 

PARAIIETER DESCRIPTION 

P1.P2 = Segnent Identifier 

PI. (0:4) = Segnent type field 

=> Data Segnent 

1 => SL Segnent 

2 => Progran Segnent 

3 => Cache Oonain 

P1.(4:12) = Progran index into CSTBLK (type 2 only) 

P2 ■ Segnent Nunber 

P3 = Disc Request Index - (DRQ Table relative) 

P4 = .(0:1) = 1 => URITE STfiRT 
= => REBD START 
.(1:15)= Ldev « 

P5.P6 - Unused. 
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Event 6 



EVENT NOTE: SIODONE 

DESCRIPTION: HErtDRV MANAGEMENT SEGMENT REBWURITE FROB/TO DISC 
COnPLETE 

CALLING MODULE: KERNELC 

CALLING PROCEDURES: SEGREBDCONPLETOR, SEGURITECOBPLETOR 

PRRRHETER DESCRIPTION 



P1.P2 ■ Segment Identifier 

P1.(0:4) = Segnent type field 

=> Data Segnent 

1 => SL Segnent 

2 -> Program Segnent 

3 -> Cache Donain 

P1.(4:12) » Program index into CST6LK (type 2 only) 

P2 = Segnent Nunber 

P3 ■ Disc Request Index (DRQ Table relative) 
P4 = . (0:1) = 1 => urite complete 

= -> Read conplete 

P5.P6 - Unused. 



Event 7 B7) 



EVENT NBBE: CGBRBBGE 

EVENT DESCRIPTION: GARBAGE COLLECTION HAS JUST TAKEN PLACE 



CALLING MODULE: KERNELC 

CALLING PROCEDURE: COLLECTGBRBAGE 



PARAMETER DESCRIPTION 



P1 = BANK OF SOURCE JUST MOVED FROB 

P2 = BDDR OF SOURCE JUST MOVED FROM 

P3 = nOVEPBOECNT, NU11BER OF PAGES JUST MOVED FROM 

P4.P5.P6 - Unused. 
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Event 8 (Z10) 



EVENT HfiflE: SUAPIH 

DESCRIPTION: SUBP IN B PROCESS 



CALLING MODULE: KERNELC 
CULLING PROCEDURE: SUBPIN 



PBRPWETER DESCRIPTION 



P1 = 


PIN OF PROCESS BEING SLAPPED IN 


P2 = 


.(0:1) = 





=> BEING SUAP 






1 


=> END SUBP 




.(1:1) = 





=> NORMAL (PARTIAL SUBP OK) 






1 


=> SUAP REQUIRED 




.(12:4)= 





=> PROCESS SUBPIN COMPLETE 






2 


=> NO ROOM, HBRO REO IIAV SUCCEED 






3 


=> NO ROOD, HARD REO FAILED 






4 


=> SUBPIN STOPPED - MORE URGENT ACTIVITY 






8 


=> NO LOCK SPACE 


P3 - 


H8RDREQUEST 


= TRUE => HARD REQUEST ON SUBPIN 








FALSE") NORMRL 


P4.P5.P6 - Unused 


. 
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rlMSTRT EvEnt Group 1 (Benory Manager) 



Event 12 (Z141 



EVENT NBBE: BLLOCBEB 

DESCRIPTION: FOUND fl HOLE FOR A SEGMENT REPLACEMENT REQUEST 

CALLING BODULE: KERNELC 
CALUNG PROCEDURE: RESERVEREGION 

PARAMETER DESCRIPTION 

PI = REQUESTED SIZE IN PBGES 
P2 = BANK OF SELECTED REGION 
P3 = ADDRESS OF SELECTED REGION 
P4.P5.P6 - Unused. 



Event 13 K15) 



EVENT NAME: OEBLLOCM 

DESCRIPTION: RELEASE REGION OF BEBORY TO AVAILABLE STATUS 



BBSTATS Events 



Event 14 U16) 



Event Nane: CACHEMOV 

Description: A cache nove (i.e. logical disc request) has 

just conpleted. 
Calling Module: CACHESEG 
Calling Procedure: ProcessCDTLogReqQue 



Paraneter Description 



P1.P2 = Segnent identifier of target DST (LDR'BUFDST) 

P2.(0:1) = 1 then this is a stack. 
P3 = Mapped Donain CDT entry nunber 

P4 = Transfer count 

P6.P6 = Unused 



CALLING MODULE: KERNELC 
CALUNG PROCEDURE: RELEBSEREGION 



PARAMETER DESCRIPTION 



Event 15 W7) 



Event Nane: GET_CDT 

Description: Called uhen an entry in the CDT table is 

obtained or released. 
Calling Module: CBCHESEG 
Calling Procedures: Get'CDT'Entry, CDT'Free'Entry. 

CDT'Get'MD'Entry, CDT'Rel'BD'Entry 



Paraneter Description 



P1 = SIZE RELEASED IN PBGES 
P2 = BANK OF RELEASED REGION BASE 
P3 = ADDRESS OF RELEASED REGION BASE 
P4.P5.P6 - Unused. 



PI 
P2 



P3 



- CDT entry nunber 
= Type oF call 

~ Free entry 

1 - Get entry 

2 = Get Mapped Donain entry 

3 = Release Mapped Donain entry 
= If P2=3 then Ldev Entry nunber 



P4.P5.P6 Not used. 
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HHSTAT3 Evtntl 


K1STATS Evtntl 


EYtirt it im) 


mST«T Evtnt Group J 




Evtnt -20 (-124) 


Evtnt Nam; BOE UNI 




Description: Called whan an LDR il queued onto tht COT 




Calling Module: CACHESEG 


EVENT MINE: ALCSTILK 


Celling Procedure: CDT'Qutut'LDR 


DESCRIPTION: REQUEST TO RESERVE A BLOCK OF ENTRIES IN THE CSTX 


Ptmwtir Description 


CRLUHG MODULE: KERHELO 




CALLING PROCEDURE: ALCSTBLOCK 


PI * Hepped Donein COT intry nunbtr 
P2 ■ LOR entry index to bi queued 


PARAMETER DESCRIPTION 






P3 ■ Quiut type 

XI 2 - COT inpeded queue 




P1»EIX CST BLOCK INDEX ASSIGNED 


X13 - COT active qutut 


P2-CSTX DST RELATIVE INDEX OF IBRD 


P4,W,P6 Not uttd. 


OF THE FIRST RESERVED CSTK ENTRY 




P3*N NUMBER OF CSTX ENTRIES RESERVED 




P4,P6,P6 - Unuttd. 


Evtnt 17 (M1) 




Evtnt N«m: DOUE LWt 




Otocription: CtlTtd when in LDR it rtnoved fron the COT queue. 




CilUng lloduli: CACHESEG 


Evtnt -21 (X25) 


Calling Proctdurt: CDT'Dequeue 1 LOR 






EVENT HAKE: OEALCSTBLK 


P*rantttr Oticription 


DESCRIPTION: INDICATES THAT A CST EXTENSION BLOCK HAS BEEN 




DEALLOCATED 


P1 > happed Donein COT intry nunbtr 


CALLING MODULE: KERNELD 


P2 ■ LOR tntry index being rtnoved fron tht qutut 


CALLING PROCEDURE: DEALCSTBLOCK 


P3 • Qutut typt 

X12 - COT inptdtd qutul 




PARAMETERS PARAMETER DESCRIPTION 


X13 - COT active qutut 




P4,P5,P6 Not und. 


P1-EIX CST BLOCK INDEX ASSIGNED 




TO THE BLOCK OF CST ENTRIES 




P2.CSTX DST RELATIVE INDEX OF UORD 




OF THE FIRST CST ENTRY TO BE 


Evtnt 18 «K) 


RELEASED 




P3=MCNT =(«ALU)CBTED CSTX ENTRIES- 




•ENTRIES BEING RELEASED)^ 


Evtnt Nam: FINDJE 


P4,PS,P6 - Unused. 


Dttcription: Calltd uhtn nttd to find in assigned COT 




Dtvict tntry. 




Calling lloduli: CRCHESEG 




Calling Proctdurt: COT'find'OE 




Paranettr Description 




Pt * Ldtv nunbtr of tht COT Dtvice tntry to be found. 




P2 * COT Dtvict tntry 




P3,P4,P5,P6 Not ustd. 
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HHSTATS Events 


MMSTATS Events 


Event -23 (-K7) 


HMSTAT Event Grogo 4 [Scheduling) 


EVENT NAME:REUiESOURCES 




DESCRIPTION: RESOURCES (VDS.MAIN MEMORY, ST ENTRY) RESERVED FOR TNE 


Event 40 (150) 


FOR THE SEGMENT HAVE BEEN RELEASED 




CALLING NODULE: KERNEU) 


EVENT NAME: QUIESCE 




DESCRIPTION: PROCESS SUITCH - STATE OF PROCESS SAVED 


CALLING PROCEDURE: RELOATASEG 






CALLING MODULE: KERNELC 


PARAMETERS PARAMETER DESCRIPTION 


CALLING PAOCEDURE: DSP 


P1-NEU DB OST NUMBER 


PARAMETER DESCRIPTION 


P2*DELTA P AT EXCHANGEDB CALL 
P3=STBTUS AT EXCHANGEDB CALL 




PI = PCBOO(CPCB) 


P4.P5.P6 - Unused. 


.(0:1) = 1 => SRR - SCHEOUUNG ATTENTION REQUIRED 




.(2:1) « 1 => CRIT - PROCESS IS CRITICAL 




.(3:1) = 1 => HSIR - PROCESS HAS SIR 




.(4:1) = 1 => PIOVR - PENDING PI, PROCESS CRITICAL 


MnnSTflT Event Group 3 


.(5:1)= 1 => HSPRI - HOLD SIR PRIORITY 




.(6:1) = 1 => IPEXP - INCORE PROTECT EXPIRED 




.(7:1)= 1 => PC - PREEMPT CAPABILITY 


(NOT CURRENTLY ASSIGNED) 


.(8:1) = 1 => HP - MUST PREEMPT 




.(9:1) = 1 => LU - LONGUAIT 




.(10:1)= 1 => SU - SHORT UAIT 




.(11:1)= 1 => TRU - TERMINAL READ UAIT 




.(12:1) =1 => USEQO - USED A QUANTUM SINCE TRANSACTION 




BEGAN 




.(13:1)= 1 => HIPRI - HOU IMPEDED PRIORITY 




.(14:1)= 1 => ALLOU SOFT INTERRUPTS EVEN THOUGH IN 




SYSTEM CODE 




.(15:1)= 1 => RITBK - PROCESS IN RIT BREAK 




P2 = PCB04(CPCB) 




.(0:1) = 1 => M - MOURNING URIT 




.(1:1) = 1 => RG - GLOBAL RIN UAIT 




.(2:1) = 1 => RL - LOCAL RIN UAIT 




.(3:1) « 1 => MA - MAIL UAIT 




.(4:1) = 1 => BIO - BLOCKED 10 UAIT 




.(5:1) = 1 => 10 - 10 UAIT 




.(6:1)= 1 => UCP - UCOP UAIT, RIT UAIT 




.(7:1) = 1 => JNK - JUNK UAIT 




.(8:1) = 1 => TIM - TIMER UAIT 




.(9:1) = 1 => INT - INTERRUPT UAIT 




.(10:1)= 1 => SON - SON UAIT 




.(11:1)= 1 => FA - FATHER UAIT 




.(12:1)= 1 => IMP - PROCESS UAITING TO UHIMPEOED 




.(13:1)= 1 => SIR - PROCESS UAITING FOR SIR 




.(14:1)= 1 => TIM - PROCESS UAITING FOR TIME OUT 




.(15:1)= 1 => MEM - PROCESS UAITING FOR MEMORY 


G.01.00 


G.01.00 


20- 15 


20- 16 



MMSTATS Events 



P3 = PCB13CCPCB) 
.(0:1) ■■ 



1 => DISPO - PROCESS ON DISPATCHING QUEUE 

(1:1) ■ 1 => L SCHEDULING CLP.SS 

(2:1) = 1 => C SCHEDULING- CLASS 

(3:1) = 1 => D SCHEDULING CLASS 

(4:1)= 1 => E SCHEDULING CLASS 

(5:1) = 1 => INTER- PROCESS IS INTERACTIVE 

(6:1) = 1 => CORER- PROCESS IS CORE-RESIDEHT 

(8:8) - PROCESS' SCHEDULING PRIORITY 



P4.PS.P6 - Unused. 



MHMSTBT Event Group 5 
(SEE CHAPTER 18 FOR THESE EVENTS) 



G.01.00 
20- 17 



MMSTATS Evcnt< 

ffllSTflT Event Group 6 (FILESYS) 
THESE EVENTS ARE FOR DEVELOPMENT USE ONLY AND ARE NOT NORMALLY ENABLED 

Event -G0(Z74) 

EVENT NAME: FOPEN 
DESCRIPTION: OLD FILE OPEN 

CALLING MODULE: FILEACC 

CALUNG PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE t (0:2)=2 -> NON-SPOOLER ACCESS 

(0:2).NE.2 -> 

P2= AOPTIONS SEE INTRINSICS NBNUAL 

P3= FILE LABEL FOPTIONS SEE INTRINSICS MANUAL 

P4= RECORD SIZE 

P5= FILE LABEL BLOCK SIZE 

P6= • OF BUFFERS 
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MMSTRTS Events 



Event -6HX75) 

EVENT NAME: FOPEH' 

DESCRIPTION: OLD FILE OPEN (CONTINUATION OF EVENT -60) 

CALLING NODULE: FILEACC 

CALUNG PROCEDURE: FOPENDA 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE LABEL FILE UNIT HSU 

P2* FILE LABEL FILE UNIT LSU 

P3= FILE LABEL » OF EXTENTS 
P4-P6 unused 



Event -60(Z74) 

EVENT NAME: FOPEN 
DESCRIPTION: NEU DISC Flu OPtN 

CALLING MODULE: FILEACC 

CALUNG PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE * 

P2= AOPTIONS 



HMSTATS Events 

Event -6UZ75) 

EVENT NAME: FOPEN' 

DESCRIPTION: NEU DISC FILE OPEN (CONTINUATION OF EVENT -60) 

CALUNG NODULE: FILEACC 

CALLING PROCEDURE: FOPEN 

PARAMETERS PARAMETER DESCRIPTION 

P1= FCB FILE UHIT 

P2= FCB MAX « EXTENTS 

P3= (0:8)= INITIAL ALLOCATION EXTENTS 

P4-P6 unused 



(0:2)=2 -> NON-SPOOLER ACCESS 

(0:2). NE. 2 -> 

SEE INTRINSICS MANUAL 



P3= FOPTIONS SEE INTRINSICS MANUAL 
P4» RECORD SIZE 
P5= 8L0CK SIZE 
P6= # OF BUFFERS 



C-.01 .00 

"20-19 
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WISTHTS Evtntt 



EVENT HflhE: FREW 
DESCRIPTION: 

CALLING KOOULE: FILEIO 

CALLING PROCEDURE: FRERO 

PRRRflETERS PARRRETER DESCRIPTION 

PI" FILE « 



P2" ACBTU3G 
P3" FLAGS 



TRANSFER COUNT 
(15:1) Buffir hit fltj 



Evwj -B(H7| 

EVENT NAHE: FURITC 
DESCRIPTION: 

CULLING I10DULE: FILEIO 

CALLING PROCEDURE: FURITE 

PARAMETERS PMiMETER DESCRIPTION 

P1« FILE « 



0.01.00 
»- 23 



flflSTRTS Evintl 

Evint -MH100) 

EVENT NAME: FIEROOIR 
DESCRIPTION: 

CRLLINO HODULE: FILEIO 

CRLLINO PROCEDURE: FREADOIR 

PRRRflETERS PAARflETEA DESCRIPTION 

P1" FILE • 



P2" RCJTLOO 
PS" FIDOS 
P4" NEC « 
PS" REC * 
PS" NOT USED 



TRANSFER COUNT 
(15:1) Buffir hit fUg 



P2» TCOUNT 


SEE INTRINSIC flANUAL 




PS' FLOGS 


(15:1) Buffir hit fl«g 






6.01.00 
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rtflSTBTS Evtntl 


HMSTATS Events 


Event -65(11011 




Event -66(1102) 


EVENT HRrtE: FURITEDIR 
DESCRIPTION: 




EVENT NflflE: FUPDRTE 
DESCRIPTION: 


CRLLINO NODULE: FILEIO 




CRLLINO IIODULE: FILEIO 


CRLUHO flODULE: FURITEDIR 




CRLLING PROCEDURE: FUPDRTE 


PRRRflETERS 


PRRAflETER DESCRIPTION 


PRRRflETERS PBRRflETER DESCRIPTION 


PI" FILENUT1 




PI" FILE * 


P2> TCOUNT 


Sie Intrintic ninull 


P2» TCOUNT Sic Intrinsic iwnuii 


PS' FLROS 


(15:1) Buffir hit fl»a 


PS" FLROS (15:1) Buffir hit flio. 


P4" REC » 


nsu 


P4-P6 not used 


P5» REC « 


LSU 


Evin, -67(1103) 


PS' NOT USED 




EVENT NRflE: IOURIT 
DESCRIPTION: 

CALLING flODULE: FILEIO 

CALLING PROCEDURE: IOURIT 

PRRRflETERS PBRRflETER DESCRIPTION 

P1» FILE • 

P2= RCBTLOO TRANSFER COUNT 

P3= FLAGS (15:1) buffer hit flaj. 
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ItdSTHTS Events 



Event -68U104) 

EVENT NAME: FRERDSEEK 
DESCRIPTION: 

CBLUNG MODULE: FILEIO 

CALLING PROCEDURE: FREBDSEEK 

PflRfinETERS PARAMETER DESCRIPTION 

P1= FILE* 

P2= FLAGS (15:1) buffer hit flag 

P3= REC » nsu 

P4= REC » LSU 

P5-P6 not used 

Event -69 (Z1QS) 

EVENT NAME: FSPACE 
DESCRIPTION: 

CBLUNG MODULE: FILEIO 

CULLING PROCEDURE: FSPRCE 

PflRfinETERS PHRBHETER DESCRIPTION 

P1 = FILE * 

P2= DISPLACEMENT SEE INTRINSIC MANUAL 

P3-P6 not used 
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flnSTRTS Events 



Event -72 (Z110) 

EVENT NOME: FSETMODE 
DESCRIPTION: 

CALLING MOOULE: FILEIO 

CALLING PROCEDURE: FSETMODE 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE # 

P2= MODEFLRGS SEE INTRINSIC MANUAL 

P3-P6 not used 

Event -74 (Z1121 

EVENT NAME: FCHECK 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FCHECK 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE • 

P2= ERRORCODE SEE INTRINSIC ISBNUBL 

P3-P6 not used 



MMSTATS Events 

MMSTBT Event Group 7 (FILESYS) 
THESE EVENTS ARE FOR DEVELOPMENT USE ONLY AND ARE NOT NORMALLY ENABLED 

Event -70 (£106) 

EVENT NAME: FPOINT 
DESCRIPTION: 

COLLING MODULE: FILEIO 

CALLING PROCEDURE: FPOINT 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE II 



P2= REC « 



nsu 



Event -71 (Z107) 

EVENT NAME: FCONTROL 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FCONTROL 

PARRMETERS PARAMETER DESCRIPTION 

P1= FILE # 

P2= CODE See Intrinsics nanual 

P3-P6 not used 
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MMSTATS Events 

Event -75 1Z113) 

EVENT NAME: FGETINFO 
DESCRIPTION: 

CALLING MODULE: FILEIO 

CALLING PROCEDURE: FGETINFO 

PARAMETERS PARAMETER DESCRIPTION 

P1= FILE * 
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P2= FOPTIONS 


SEE INTRINSIC MANUAL 






P3= AOPTIONS 


SEE INTRINSIC MANUAL 






P4-P6 


not used 


Event 


-76 (Z114) 






EVENT NAME: FREADLABEL 
DESCRIPTION: 




CALLING MODULE 


FILEIO 






CALLING PROCEDURE: 








PARAMETERS 


BRBMETER DESCRIPTION 






P1= FILE It 








P2= TCOUNT 


SEE INTRINSIC nANUAL 






P3-P6 


unused 
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MSTRTS Evinti 



Evtnt -7? »11S) 

EVENT NAflE: FURITELR8EL 
DESCRIPTION: 

CALLING WHILE: FILEIO 

CULLING PROCEDURE: FURITELABEL 

PBRBBETERS PARAMETER DESCRIPTION 

PI' FILE II 

P2- TCOUNT SEE INTRINSIC IfflUAL 

P3-P6 unuwd 

Event -78 B116) 

EVENT HM1E: FLOCK 
DESCRIPTION: 

CALLING ItOOULE: FILEIO 

CALLING PROCEDURE: FLOCK 

PBRB1ETERS PARAnETER DESCRIPTION 

PI- FILE * 

P2» LOCKCOHD S« Intrintict nanual 

P3- COW COOE 
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nnSTHTS Evifitl 



NHSTBT Event Group 8 
Event -80 [II 20) 
EVENT NflflE: FREMITI 

description: 
calling hooule: fileacc 
calling procedure: frenbbe 

paraheters paratieter description 
pi* file ii 



P2-P6 



unuttd 



Evtnt -»l K121) 

EVENT NONE: FCLOSE 
DESCRIPTION: 

CALLING HOOULE: FILEBCC 

CALLING PROCEDURE: FCLOSE 

PRRRRETERS PRRflflETER DESCRIPTION 

P1= FILE II 

P2- DISP Set Intrinsic nanual 

P3= SECCODE 

P4-P6 unwed 



BltSTATS Evtntt 

Evtnt -79 (Z1171 

EVENT NRHE: FUNLOCK 
DESCRIPTION: 

CALLING NODULE: FILEIO 

CALLING PROCEDURE: FUNLOCK 

PARArlETERS PARAMETER DESCRIPTION 

P1» FILE II 



P2-P6 



united 
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IttSTATS Evtntt 



Evtnt 83 (1123) 

Evtnt Nant: STRATEGY 

Dttcription: Called to dtttmint tht type of ttrategy uied 

bated on uho tht caller of CDT'NTTRCHIO it. 
Calling Itodule: CACHESEG 
Calling Procedure: COT' STRATEGY 

Paraneter Dttcription 



P1 ■ COT Happed Oonain entry 
P2 ■ LDR entry index 
P3 « Strategy 

- Unknown caller 

1 - Unknown fron Filt Sytttn 

2 - Spooler 

3 - Directory 
4-7 - Unknown 

8 - Gennettagt 

9 - Filt Sytttn, Ouittce I/O 

10 - Filt Sytttn, ttquential, NOBUF 

11 - File Sytttn, direct, NOBUF 

12 - Fill Sytttn, tequential, BUF 

13 - Fill Sytttn, direct, BUF 

14 - Fill Sytttn, KSBB 

15 - Fill Sytttn, IP.AGE 
F4,P5,P6 Not uted. 
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HflSTRTS Evintt 



Event Nane: INITIATE 

Description: Called uhen etarting/eonpleting logical disc 

request. 
Calling flodule: CflCHESEG 
Calling Procedures: COT* Initiator, CDT'Conpletor 

Paraneter Description 



P1 


= COT flapped Donain entry 


nunber 


K 


= LDR entry index 




n 


= We 

= Initiator 

1 - Completer 




P4,PS,P6 Not used. 




Event 86 (11 26) 





Event Nane: COT BTT 

Description: Called frun CDT'BTTACKIO. 

Calling Itodule: CflCHESEG 

Calling Procedure: CDT'flttachio 

Paraneter Description 



P1 = Ldev 

P2 = Function 

P3 * Flags 

P4.P5 = Pam1, ParnZ 

P6 = Count 



Event 87 W27) 



Event Nane: HRPJOR 

Description: Called uhen need to "nap" a disc donain. 

Calling nodule: CflCHESEG 

Calling Procedure: COT'llBP'CflCHED'DOnSIN 

Paraneter Description 



P1 = Neu CDT entry nunber 

P2 = Returned CDT entry 
P3,P4,P5,P6 Hot used. 
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nnSTSTS Events 



nnSTHT Event Group 9 (Disc I/O Requests) 



Event 90 W32) 



Event Nane: REQCflCHE 

Description: Called to see if caching uill accept this 

I/O request. 
Calling Kodule: CflCHESEG 
Calling Procedure: REOUEST' CACHE 



Paraneter Description 

P1 = LDR entry index 
P2,P3,P4,P5,P6 Hot used. 



Event -98 (Z142) 

EVENT NflBE: DISK TRAFFIC 

DESCRIPTION: DISC I/O REOUEST HAS BEEN QUEUED 

CALLING HODULE: HflRDRES 

CALLING PROCEDURE: ATTRCHIO 

PflRflnETERS PBRflnETER DESCRIPTION 

PKNT DATS TRANSFER CDUNT:IIORDS IF x>; 

BYTES IF <0 

P2=FLflGS.(0:4) 

P3-FNCT =0 ==>READ 

'1 «>URITE 
=2 «>OPEN FILE 
=3 «>CLOSE FILE 
=4 ==>CLOSE DEVICE 



nnSTRTS Events 



Event 18 (1130) 



Event Hane: UHJRP.RG 

Description: Called uhen disc donain no longer napped, (i.e. both 

the logical and physical I/O is complete). 
Calling nodule: CflCHESEG 
Calling Procedure: CDT'nflP'CflCHEO'REGION 

Paraneter Description 



P1 = CDT Ldev entry nunber 

P2 = Region CDT entry nunber 

P3,M,P5,P6 Not used. 



Event 89 (Z131) 



Event Nane: UHK_REG 

Description: Called uhen a disc donain gets linked into the 

linked list of donains for an ldev. 
Calling nodule: CflCHESEG 
Calling Procedure: LINK'CACHED'REGION.UNLINK'CflCrlED'REGION 



Paraneter Description 



P1 = Type 

= Link 

1 = Unlink 

P2.P3 = Address of region base 

P4 = CDT entry nunber found in the header 

P5 = It of pages 



PS Not used. 
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nnSTHT Event Group 10 

Event 100 (Z144) 

EVENT NRflE: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLIHG HODULE: I0FDISC1 

CALUKG PROCEDURE: FHDDVR 

PflRflnETERS PBRflnETER DESCRIPTION 

P1=DIPT(DSTAT) HARDWIRE STATUS 

P2=so ojtisc 

P3=I00P(QLDEV).QL0EVH LOR ST0C0UNT4LSL(8)) 
=LDEV/SIO PROGRBn COUNTER 
Event 101 (Z145) 

EVENT NAnE: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 

CALLING HODULE: IOMOISCO 

CALLING PROCEDURE: nHDDVR 

PflRRRETERS PRRBilETER DESCRIPTION 



P1=DIPT(DSTAT) HBRDUARE STATUS 

P2=so anise 

P3=IOQP(0LDEV).<ILDEVN LOR STOCOUHTiLSl(S)) 

=LDEV/SIO PROGRfln COUNTER 
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HIBTATS Events 



fWSTBT Event Group 11 



iwrt -119 W,M) 



EVENT NANE: START I/O 

DESCRIPTION: DRIVER INITIATOR FOR SIO DEVICE HAS IEEN CALLED 

CALLING nODULE: HARORES 



callino procedure: siodn 
parameters 



PARAIIETER DESCRIPTION 



P1>IO0PL(0STAT) LOR I00PL(QLDeV).LMVN 
■(0:8) PC! ENTRY It OF PROCESS NAKINO REQUEST 
(1:1) LOC-ICAL DEVICE NUMER OF DEVICE FOR I/O 
P2«OT(OJBCT)»U0M> COUNT IFtfsBYTE COUNT IF<0 
P3«(0:2) • FUNCTION CODE SPECIFIED 8Y DRIVER 

• •> READ 
■ 1 ■> URITE 
" 2 ■> CONTROL 

»C6:10)- DSTN OF TARGET DATA SEG 



Event -111 fat1S7> 

EVENT NRHE: I/O COWLETION 
DESCRIPTION: SIO COMPLETION 

CALLINO NODULE: HARORES 

CALLING PROCEDURE: SIOON 

PARAMETERS 



PARAKTER DESCRIPTION 



PWOQP(QLDEV).LDEVN*LOOICAL DEVICE NW1BER OF 
DISC INVOLVED IN TRANSFER 
P2»I0QP(QPAR1) (DEFINED BY DRIVER) 
P3«I0OP(0PAR2) (DEFINED BY DRIVER) 
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ItnSTBTS Evmtl 



NNSTBT Event Group 13 



Event 139 (Z2131 



Event Nam: C ABSENT 

Description: Either the napped ditc senain or the target 

DST iia absent uhen a cache nove ua> attenpted. 
Calling nodule: CACHESEG 
Calling Procedure: PROCESSCDTLOGREOOUEUE 

Psraneter Description 



PI '0 Mapped Donain abttnt 

P2 "Pin 

P3.P4 • Sejnent identifier oF napped Donain 

P5.P6 Hot oeed. 



' LDR entry index (DST not preeent) 

■ Pin 



r« ■ rin 

P3.P4 » Segnent identifier of DST (P4.(0:1) » 1 stack) 

P5.P6 Not uied. 



HNSTATS Evtnti 



WISTAT Event Croup 12 

tvmt i« am 

EVENT NANEi SOFT'DEATH 
DESCRIPTION: BUG CATCHER 

CALLING NODULE: HARORES 

CALLINO PROCEDURE: SOFT'DERTH 

PARANETERS PARAIIETER DESCRIPTION 



PI 
P2 
P3 



SOFT'DERTH I.D. NUNBER 
CALLERS STATUS REGISTER 
CALLERS DELTA P 



Event Iffl «17B) 



EVENT MANE: IOBUFTRP 

EVENT DESCRIPTION: I0SYSTEN BUFFER TRAP 

CALLING NODULE: HARORES 
CALLING PROCEDURE: SIOON 

PARAIIETER DESCRIPTION 

PI ' IOW 

P2 ' I0O»(QDSTN).0STN > DST NUNBER OF BUFFER 

P3 »0 



G.01.00 
20- 38 



nnSTATS Events 

NNSTAT Event Group 14 (CS/3OO01 

Event 140 («14) 

EVENT NAflE: COPEN 
DESCRIPTION: 

CALLING NODULE: COHSYSZ 

CALLING PROCEDURE: COPEN 

PARANETERS PARANETER DESCRIPTION 

P1 (0:8) • CS ERROR CODE 

(8:8) ' LOGICAL DEVICE NUNBER 

P2 PHAP1 

P3 PIWP2 



G.01.00 
20- 39 



0.01. 00 
20- 40 



nitSTRTS Events 



Event 142 fZZ1 6> 

EVENT NBBE: CflBORTIO 
DESCRIPTION: 

CALLING OOOULE: CONSYS1 

CBLUNG PROCEDURE: CflBORTIO 

PBRAI1ETERS PRRABETER DESCRIPTION 

P1 LOGICAL DEVICE 

P2 IOQINDEX 

P3 
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Event 147 (Z223) 

EVENT NfitlE: CREflD 
DESCRIPTION: 

CALLING NODULE: C0ASVS4 

CALLING PROCEDURE: CREBD 

PARAMETERS PBRABETER DESCRIPTION 

P1 (0:8) = CS ERROR CODE 

(8:8} = LOGICAL DEVICE NUtlBER 





P2 


INCOUNT 






P3 


STATION 




Event 149 (Z225) 








EVENT NBBE: CURITE 
DESCRIPTION: 






CALLING BODULE 


CGRSYS4 




CALLING PROCEDURE: 


.CURITE 






PARABEKKS 


PARBBETER DESCRIPTION 




P1 


(0:8) = 
(8:8) = 


CS ERROR CODE 
LOGICAL DEVICE NUBBER 




P2 


OUTCOUN 






P3 


INCOUNT 





BBSTRTS Events 

Event 144 (Z220) 

EVENT NBBE: CSIOUBIT 
DESCRIPTION: 

CALLING BODULE: C0BSVS1 

CRIUNG PROCEDURE: CSIOUBIT 

PARAMETERS PARAnETER DESCRIPTION 

PI (0:8) = CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUB8ER 

P2 TRANSMISSION LOG 

P3 



Event 146 UZlVi 

EVENT NflBE: CCLOSE 
DESCRIPTION: 

CALUNC- BODULE: C0BSVS3 

CALLING PROCEDURE: CCLOSE 

PARABETERS PARAMETER DESCRIPTION 

P1 (0:8) - CS ERROR CODE 

(8:8) - LOGICAL DEVICE NUBBER 

P2 LINE NUBBER 

P3 
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MBSTBTS Events 

BBSTAT Event Groua 15 (CS/3000) 

Event 150 (Z226) 

EVENT NABE: CSDRTVER 
DESCRIPTION: 

CALLING nODULE: BSCLCB 

CALLING PROCEDURE: CSDRWER 

PRRflBETERS PARBBETER DESCRIPTION 



P1 TIBER 



LSU 



P2 CURRENTSTBTE 
P3 CURRENTEVENT 
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UHERE THE DRIVER IS IN THE 

STATE TRANSITION TABLE 

(0:8) = CURRENT EVENT 

(8:8) = LOGICAL DEVICE 

UKAT CAUSED THE DRIVER TO BECOBE 

ACTIVE 



Event 152 (X230) 



Pv'ENT NRBE: CCONTROL 
DESCRIPTION 



CALLING BODULE: C0BSYS5 

CALLING PROCEDURE: CCONTROL 

PBRBBETERS PARAnETER DESCRIPTION 

P1 (0:8) - CS ERROR CODE 

(8:8) = LOGICAL DEVICE NUnBER 

P2 CONTROL CODE 

P3 PARAnETER 
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IMSW3 Evinti 



tint 15? mV) 

EVENT NAM: COPEHTRACEFILE 
DESCRIPTION: 

CALLING AOOULE: 

CALLING PROCEDURE: COPENTRACEFILE 

PARAAETERS PARAMETER DESCRIPTION 

PI (0:1) > CS ERROR CODE 

(l:t) • LOGICAL DEVICE NUMER 

Pi CTRACEINFO 

n o 
Evtn^ IB (BK) 

EVENT NAAE: CCLOSETRACEFILE 
DESCRIPTION: 

CALLING NODULE: 

CALLING PROCEDURE: CCLOSETRACEFILE 

PARAflETERS PRKAHETER DESCRIPTION 

P1 (0:8) • CS ERROR CODE 

(8:8) ■ LOGICAL DEVICE NUIBER 

P2 

n o 



WWTBTS Ewnti 

tvtnt 188 IBM) 

EVENT NATS; CPOLUST 
DESCRIPTION; 

CALLING nODULE: 

CALUNS PROCEDURE: CPOLUST 

PRRABETERS PARME TER DESCRIPTION 

P1 LOGICAL DEVICE 

PZ CS ERROR CODE 

ps phap 
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IHSTATS Evtntl 



MSTAT Ewit Group 16 



Evont 160 (1240) 



EVENT NAM: CREW 
DESCRIPTION: 



CALLING NODULE: OSflM 
CALLING PROCEDURE: 



PARAMETERS PARAflETER DESCRIPTION 

P1- TINE SIRUP 

P2- (0:4) NOT USED 

(4:1) BLOCK 
(5:2) STATE 
(7:3) NEXT 
(10:1) :>0 INITIALIZATION EVENT 

:-1 COBPLETION EVENT 
(11:5) SUB EVENT NUflBER 





P3> DEPENDS ON THE SUB EVENT NUnOER AND 




IF IT IS AN INITIALIZATION OR COHPLETION EVENT 




USB: 


(0:4) 
(4:6) 


STPJITyPX 
tISGCLS 








(10:16) STRNTYP 




sue 


SUB EVENT 




INIT 


COflP 


EVENT NO. 


NAAE 




PARK 


PART 




CAEAD 







UN 




CURITE 




X BSG 


IEN 




IOUAIT 







LEN 




CCHECK 







ERRCOO 




DSATTN 












DSUC 




x nSG 


R ASG 




CHNGEUAIT 




PARA 







BONREO 




AEO 





10 


CABORT 







T/F 


11 


CRESET 










12 


CSOATA 




R BSG 




13 


CSREREAO 
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IWSTAT Ewit Orouc 18 



IWTATS EvMtt 



Evmt 191 (1277) 



EVENT NAfE: DISKINTRPT 

DESCRIPTION: A 7905/7920 CONTROLLER IS PROCESSING AN ATTENTION INTERRUPT 
(ONLINE/OFFLINE) 
CALLING DODULE: HARORES 

CALUNG PROCEDURE: SIODB 

PARABETEAS PAKABETER DESCRIPTION 

PI' »ITP (US)-i.c. UNO GOT THE INTERRUPT 



P2» »ITP (THEN)-i.t. UNO AAA THE POLL PROGAAA 



P3» DITP 



"OUR" DIT FLAGS UORD 



THERE SHOULD 8E AT LEAST AN 1300 AND AN {303 FOR EACH SIO PMM1. 
A SINGLE ISOLATED (IN TIHE) SEOUEST UILL GENERATE AT LEAST A 
1303, 1300, 1303. IF THE OUEUE OF 100'S ON A DIT NEVER EBPTIES, 
THERE UOUU) BE ONE 1300 AND ONE 2303 PER SIO PRGfl. 
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IWSTBTS Evtntt 



Event 192 tt300) 



EVENT NRHE: GIPINTERRUPT 

DESCRIPTION: INTERRUPT JUST PROCESSED 



CALLING NODULE: HfiRDRES 
CALLING PROCEDURE: (IP 
PARANETERS 
P1 



PZ 
P3 
M 
P5 
P6 



PARAMETER DESCRIPTION 
LDEV 

QUEUE ELEHENT UORD ENTRY INDEX 

CONTENTS OF DIT UORD C: THE FLAGS UORD 

CHANNEL PROGRAfl INSTRUCTION POINTER 

CONTROLLER STATUS 

LSU of a Return fron TWER 
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IWSTBTS Events 

Event 193 (1301) 

EVENT NANE: STARTIO 

DESCRIPTION: Issuing SIOP nachine instruction. 

CALLING nODULE: HARORES 

CRLLING PROCEDURE: STflRT'HPIB, STRRTIO 

PARAHETERS PARAHETER DESCRIPTION 



PI 
P2 
P3 
P4 
P5 
P6 



Absolute address of SIO prograii to start. 

LDEV nunber 

DRT nunber 

0' ENTRY' INDEX FROH OITP(DIOQP) 

DIT UORD 0: THE DIT FLAGS UORD 

LSU of B RETURN FROH R CRLL TO TWER 
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HNSTATS Events 



Event 194 CX3021 

EVEHT NAHE: SIODH-ENTRY 
DESCRIPTION: Entering SIODH 

CRLLING NODULE: HRRDRES 

CALLING PROCEDURE: SIODN 

PARAHETERS PARAMETER DESCRIPTION 

PI = LDEV 



P2 
P3 
P4 
P5 
P6 



IOQ OR ORQ table relative index 
DIT UORD (DIT FLAGS) 



CURRENT STRTE OF THE VARIABLE STRTE 
IN SIODN 



UNUSED AT THIS TINE 

LSU RETURNED BY CALL TO TD1ER 



Event 195 (Z303) 

EVENT NRNE: SIOOB-EXIT 

DESCRIPTION: Leaving SIODN nain loop. 

CALLING NODULE: HRRDRES 

CALLING PROCEDURE: SIODN 

PARAHETERS PARAMETER DESCRIPTION 



SAHE AS EVENT 194 (X302) 
EXCEPT THAT EVENT IS 195 (Z303) 



IMSTATS Events 

nnSTBT Event Group 20 

THESE EVENTS ARE FOR DEVELOPHENT USE ONLY AND ARE NOT NORMALLY ENABLED 

Event 200 (Z310) 

EVENT NDtlE: DISK8UGCATCHER 

DESCRIPTION: R NOUNTED VOLUHE TABLE CHANGE IS BEING HADE. 

CALLING NODULE: PVSYS 

CALLING PROCEDURE: HVTA8LE 

PARAHETERS PRRflnETER DESCRIPTION 

P1= FUNCT 

= DELETE ENTRY 

1 = RDD ENTRY 

2 = PRESERVE ENTRY 

P2= HVTA8X (HOUNTEO VOLUNE TABLE INDEX) 
P3= DELTRP (VALUE OF 0-2) 



Event 201 B311) 

EVENT NAHE: DISKBUGCRTCHER 

DESCRIPTION: R PRIVATE VOLUNE USER TABLE CHANGE IS BEING HADE. 

CALLING NODULE: PVSYS 

CALLING PROCEDURE: USERTABLE 

PRRANETERS PARAHETER DESCRIPTION 

P1= FUNCT 

= CREATE USER ENTRY 

1 = RENAME USER ENTRY 

2 = RETURN ALL HVTHBX INDICES USED BY A 

SPECIFIC PCB 

3 = RETURN ALL PCB POINTERS USING A SPECIFIC 

HVTABX 

4 = GET USER ENTRY 



£.01.00 

"jb- 51 



P2= IWTA8X (NOUNTED VOLUHE TABLE INDEX) 
P3= DELTAP (VALUE OF Q-2) 
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W1STRTS Ev.nn 



IB1STBT Eunt Braun 81 Proem Crtiticm inj 
Ttnunititfii Lotlctl Proem Tiblq 

twit, -811, (Hftl 

WENT NAHE: PROCESS COTtPLETION 
DESCRIPTION: PROCESS HAS TERMNATED 

CALLING NOOUIE: nORCUE 

CRLLING PROCEDURE: TERMINATE 

PARRBETERS PARAMETER DESCRIPTION 

P1«0 
P2*0 
P3«0 
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IHISTATS Evtntt 



Evtnt ta (1336) 

EVENT Nflnt: CONFIGURATION INfORWTION 
DESCRIPTION: nPE VERSION FIX UPDATE 

CALLING nODULE: OPCOnflRND 

CBL1INC PROCEDURE: CWION 

PARAWTERS PBRATIETER DESCRIPTION 

M» VERSION 

P2« FIXL 



Evtnt -223 (-Z337) 



EVENT NRPIE: CONFIGURflTION INFORNATION 

DESCRIPTION: SYSTEB TABLE LOCATIONS AND AVAILABLE LINKED IIENORY 
INFORIfflTION 
CALLING NOOUIE: QPCOWIANO 



CALLING PROCEDURE: CXtlON 



PARAMETER DESCRIPTION 



P1=F (I1032)=*CST(0)-«DST(0) 

■DISPLACEflENT TO CODE 
P2=F(Z1033)«#CST(LBST)-«KT«) 

•DISPLACEMENT TO SHRRRBLE 
P3»L0GICAL(T0TALSI>LSK(4))sLIW<ED HEHDRY SIZE 
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mum Evtnti 

IHISTRT Evtnt jpaa 22 
Tim SHiip of Evtnt Tr«i Enibli mi Dittblt 

\*\«\ \\\ (Has), 

EVENT NRNE: CONFIGURATION INFORHATION 
DESCRIPTION: EVENT GROUP IfflSK 

CALLING NODULE: CRIO 

CALLING PROCEDURE: CONSKOH 

PRRRflETERS PRRflflETER DESCRIPTION 

P1* HERSNSKO 

P2> HEASHSKI 

P3«Rt«trvtd 
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ItlSTflTS Evtntt 



Evtnt -224 -0:3401 

EVENT NRflE: SVSPINS 

DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING ItOOULE: OPCOIHAM) 

CALLING PROCEDURE: CffltON 

PARAMETERS PARAMETER DESCRIPTION 

P1*ABS0LUTE(Z1141)=PR0GER'S PCBENTRV NUNBER 
PZ^ABSOLUTEfZIIAZl^NAM'S PC6 ENTRY NUNBER 
P3=ABS0LUTE(Z1143)=UC0P'S PCB ENTRY NUMBER 



Evtnt -225 (-1341) 

EVENT NAME: SYSPINS(CNTO. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CHUNG IWDULE: OPCOIWBNO 

CALLING PROCEDURE: CWION 

PARAMETERS PARAMETER DESCRIPTION 

PI'ABSOLUTEOCimj-PFfllL'S PCB ENTRY NUMBER 
P2=AeS0LUTE(Z1145)>0EVREC'S PCB ENTRY » 
P3"ABS0LUTE(Z1146)=PRMSG'S PCB ENTRY • 



Evtnt -226 (-1342) 

EVENT NRNE: SYSPINSfCNTD.) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALLING NODULE: OPCOMMAND 

CRLLING PROCEDURE: CXNON 

PARAMETERS PARRNETER DESCRIPTION 

P1»ABS0LUTE(*1147)«STNSG'S PCB ENTRY • 
P2*B8S0LUTE(Z115OKOG'S PCB ENTRY • 
F3=flBS0LUTE(Z1151)«L0RD'S PCB ENTRY N 
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MHSTATS Event! 


IfflSTATS Events 


Event -227 (-Z343) 


HHSTAT Event Grain 23 (Teminil I/O) 


EVENT NAME: SYSPINSfCNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 

CALUNG NODULE: OPCOI1BBND 


Event 230 (Z346) 

EVENT NABE: TERBREAD 

DESCRIPTION: TERMINAL READ COBPLETION 


CALUNG PROCEDURE: CXItON 

PARAMETERS PARABETER DESCRIPTION 

P1*ABS0LUTE(Z1152H0BESSPROC"S PCB ENTRY * 
P2-SBSO LUTE (%1 1 53)=SVSI0PR0C ' S PCB ENTRY » 
P3=ABS0WTE(Z1154)=BEBL0GP'S PCB ENTRY * 


CALUNG MODULE: HARDRES 
CBLUNG PROCEDURE: TIP 

PBRAnETERS PARAMETER DESCRIPTION 

P1 = LDEV 

P2 = READ OURATION 

P3 = BYTES READ 


Event -228 (X344) 


Event 231 B34?) 


EVENT NABE: TinESTBHP 
DESCRIPTION: TIBESTAMP 

CALUNG MODULE: OPCOMMAHO 


EVENT NABE: DC1DC2RCK 

DESCRIPTION: 0C1/DC2 HAS BEEN SHTISFIED 

CALLING NODULE: HARDRES 
CALUNG PROCEDURE: TIP 


CALLING- PROCEDURE: CXNON 


PARAMETERS PARABETER DESCRIPTION 


PflRRHETERS PflRRBETER DESCRIPTION 

P1=CALENDAR (0:7)*YEBR OF CENTURY 
(7:9)=DfiY OF YESR 

P2=CLOCK(UORD1).(O:?M0UR OF OBY 

(8:8HINUTE OF HOUR 

P3=CLOCK(U0RD2).(O:7)=SEC0NOS INTO MINUTE 
.(8:8)=TENTHS OF SECONDS 


P1 = LOEV 

P2 • DURATION (BETUEEN START AND DC2) 

P3 - BYTES READ (EXCLUDING DC2) 


Event -229 t-X3«! 




EVENT NRI1E: BONOFF 
DESCRIPTION: END EVENT TRACING 




CULLING BODULE: OPCOBBBND 




CULLING PROCEDURE: CXMON 




PARAMETERS PARAMETER DESCRIPTION 




P1=0 
P2=0 
P3=0 
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ilBSTRTS Events 


NMSTBTS Events 




Event 234 (Z352) 


Event 232 U350) 


EVENT NABE: TERB LOGON 

DESCRIPTION: TERMINAL JUST LOGGING ON 


EVENT NBME: TERHURITE 
DESCRIPTION: URITE COMPLETION 


CRLUNG BODULE: IOTERBO 
CALUNG PROCEDURE: TERBIOB 


CALLING HODULE: IOTERBO 
CRLUNG PROCEDURE: TERBIOM 

PARAMETERS PARAMETER DESCRIPTION 


PBRRBETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = 
P3 « 


P1 = LDEV 

P2 = 

P3 - BYTE COUNT OF TRANSFER 


Event 235 (Z353) 


Event 233 (Z351) 


EVENT NABE: TERBLOGOFF 

DESCRIPTION: TERBINAL JUST LOGGED OFF 


EVENT NAME: BINREAO 

DESCRIPTION: BINARY READ COMPLETED 

CALUNG MODULE: HARDRES 
CALUNG PROCEDURE: TIP 

PARAMETERS PARAMETER DESCRIPTION 
PI = LDEV 
P2 = DURATION 
P3 = BYTES READ 


CBLUNG MODULE: IOTERBO 
CflLUNG PROCEDURE: TERBIOM 

PBRRBETERS PARAMETER DESCRIPTION 
P1 = LDEV 
P2 ■ 
P3 = 


CM M 
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20- 


59 



HMTATS Cvinti 



iaua m am 



EVERT HOKE: SPECCHRR 

DESCRIPTION: PROCESSED SPECIAL CHBRHCTER 



CALLING nODtllE: HAR0RE5 
CALLING PROCEDURE; TIP 



PARAHETER DESCRIPTION 



PBRAHETERS 
P1 • LDEV 

P2 • SPECIAL CHARACTER PROCESSED 
P3 -0 



Event 237 (13551 



EVENT MADE: BREAK 
DESCRIPTION: PROCESSED BREAK 



CALLING NODULE: HARDRES 
CALLING PROCEDURE: TIP 



PARAMETERS 
P1 ■ LDEV 
P2 ' DSTATE 
P3 »0 



Evtnt 238 (13561 



PARAHETER DESCRIPTION 



EVENT NAftE: SPECREAD 

DESCHPTION: SPECIAL READ TERWNBTION CHARACTER DETECTED 



CALLING HODULE; HARDRES 
CALLING PROCEDURE: TIP 



PARABETERS 

P1 ■ LDEV 
P2 • DURATION 
P3 ■ BCNT 



PARAHETER DESCRIPTION 
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mSTATS Evante 



fruit WJim 



I1IISTAT E«nt Group 21 (Pouer fail) 



Event Nana: PFAIL 

Detcription: Power fail detected. 

Celling Nodule: ININ, PFAIL 

Calling Prweduret: Poutrup (ININ), Poutrup (PFAIL) 

Pereneter Detcription 



PI • Calltd f ran Poutrup in ININ 

1 Called frm tntry in Poutrup in PFAIL 

2 Calltd frwi and oF Poutrup in PFAXL 

P2 ■ For P1"0 thla it 
Fop PI "1,2: 

TRUE ' tlultiplt poutrfail 
FALSE* Firtt poutrfail 



P3 ■ PF 



* No poutrfail or PFRIL proctninj conplete 

1 * Stt by the poutr doun trip in ININ 

2 * Set by the poutr up trap in ININ 

3 * Set when auekt the PFRIL proceat 

4 ■ Set by PFAIL after ntttagt appeara on eonaolt 

> SYSUP 

> Syaten not back up after pouerfail 

1 = Sytten back up after poutrfail 



P5.P6 not uted. 



G.01.00 
20- 62 



General Rootfile Layout 



CHAPTER 21 ROOTFILE LAYOUT 
General Rootfile Layout 



ROOTFILE INFORnATION 
128 uds 



PASSUORD TABLE 



PRSSUORD TABLE (CONT.) 



HEN R/U TBBLf 



SET R/U TRBLE 



DATHBRSE GLOBAL INFO 
128 uds: 



ITEM TABLE 
(variable size) 



SET TRBLE 
(variable size) 



DRTR SET CONTROL BLOCKS 
(DSCB) 
(variable size) 



The data base ROOT FILE is an HPE file uith filecode equal to -400. 
The record size is 128 uords, fixed, binary fornat uith a blocking 
factor of 1. The size of the file depends on the nunber of data itens 
and data sets defined in the data base. 
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General Rootfile Layout 



Root F ile Label 



7? 
100 



103 
104 



RL'COKDITION (IH RSCII): 

JB - Virgin. The database has not been created yet. 
FU - OK. The database is OK. 

Rn - nodified deferred. The database is being Modified. 
AC - Maintenance create. The database is being created. 
HE - Maintenance erase. The database is being erased. 
IL - ILR recovery in progress. 
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1 


RL'CONDITION 
"RL'DRTE 


_( rootf ile_condition) I 

(creation date) i 


2 
3 


RL'TIBE 


(creation tine) ! 


4 


RL'EVEROPEH I 


F 


RL'COLDLORDID 


(cold load id) I 


6 


RL'USERCOUNT 




7 
8 

ii 


RL'OBCBDSTNlin 
RL'LOOID 


_(DST_nunberjif_DBCB) I 

(log id for 
transaction logging) I 


12 
15 


RL'LOGPASS 


(log id password) I 


1b 


RL'FLRGS 

RL'STORDRTE 

RL'STORTlnE 


(database flaqs) ! 


1/ 


(DBSTORE date) 


18 
19 


(DBSTORE tine) i 


20 
21 
22 
23 


RL'BUFSPECCOUNT (buffer spec count) | 

"RL'ILRCRERTEDBTE (date ILR log created]"! 

RL'ILRCREflTETI».E"(tine~ILR"log created)"! 


24 
25 
26 


RL'ILRLRSTDRTE 
"RL'ILRLASTTME 


_(last_log_access_date)_l 
(last log access tine) j 


27 
63 


RESERVED I 
FOR 

FUTURE 

USE i 


64 
67 


RL'IWINTUORO 


(database Maintenance I 
word) I 


68 
to 
127 


RL'BUFFERSPECS 


(buffer specifications)! 



General Rootfile Layout 



Root File Label (cont.' 



RL'DRTE: Root File creation date*. Its fornat is: 

_0:_1:_2:_3:_4:_5:_6:_7:_8:_9:10:11:12:13:14:15 
I yea r I day_of _yea r | 



RL'TIflE: Root file creation tine*. Its fomat is: 

_0:_1:_2:_3:_4:J:J:_7:J:J:10:11:12:13:14:15 

I hou r | ninutes I 

I seconds I tenth_of _seconds I 

RL'EVEROPEH: This Field is no longer used under MRGE B 

RL'FLRGS: 

(0:1) - RECOVERY Default is HO (0) 

(1:1) - LOGGING Default is HO (0) 

(2:1) - ACCESS Default is YES (1 ) 

(3:1) - DUHPING Default is HO (0) 

(4:1) - RESERVEO-FOR-FUTURE-USE 

(5:2) - SU8SYSTEH ACCESS Default is R/U (00) 

(7:1) - ILR Default is HO (0) 

(8:2) - RESERVED-FOR-FUTORE-USE 

(10:1)- DIRTY FLAG Default is YES (1). 

This indicates the database has 
been nodified but not DBSTOREd. 
(11:5)- RESERVED-FOR-fUTURE-USE 

RL'STORDRTE: Sane fomat as RL'DRTE*. 

RL'STORTME: Sane fomat as RL'TIBE*. 

RL'BUFSPECCOUNT: Haxinun nunber of buffer specifications alloued. 

RL'ILRCRERTEORTE: Sane fomat as RL'DRTE*. 

RL'ILRCREBTETlnE: Sane fomat as RL'TME*. 

RL'ILRLASTDATE: Sane fomat as RL'DRTE*. 

RL'ILRLRSTTIflE: Sane fomat as RL'TIflE*. 

RL'HRINTUORD: For data bases uith no naintenance uord this field has 
2 senicolons ( ' ; j ' ) and trailing blanks. 
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General Rootfile Layout 



BIT/ _0:J:_2:_3:_4:J:._6:_7:_8:_9:10:11:12:13:14:15 

UO 68 |buffers_forJ user |buffers_for_2 users 

69 lbuffers~for~3 users |buffers~for"4 users 

. j etc..." 

- I. 



Z 

104 
105 



127 jbuffers_foM19 users_|buffers_for_120 users_ 



* The DRTE and TIHE fields can be fomatted (for display purposes) 
individually by calling the FhTCALEHDAR and FHTCLOCK Intrinsic; 
respectively. Or both fields can be fomatted at once uith FHTDATE 
Intrinsic. 
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General Roolfilt Layout 


General Rootfile Layout 


Root file Labels 1 «, i 


feal.Fili.JastlJ 




LABEL H 


1 


UORDO 

1 

2 
3 
4 
5 
6 
7 
8 
9 


LABEL #3 I 
Iten! read/urite bit nap 1 

1 2 
1 3 
1 4 
1 5 
1 6 
1 7 


uordo 

1 

2 

3 
4 
5 

6 

? 
% 
9 

10 
11 

124 
125 
126 
127 


Password for user class 
(this is a dunny field since user 
class is not defined) 




1 

2 

3 

4 

5 

6 

7 

10 

11 

12 

13 

174 
175 
176 

177 

t 

1 


Password for user class 1 


Iten2 read/urite bit nap | 10 
1 11 


Password for user class i 




15 i i i? 

16 I Iten3 read/urite bit nap I 20 

17 I I 21 

119 j i 167 

120 I Iten16 read/urite bit nap I 170 

121 I I 171 




Passuord for user class 31 




LABEL HZ 



1 


Passuord for user class 32 


2 
3 
4 
5 
6 
7 
8 
9 

10 
11 

'. 




2 
3 
4 
5 
6 
7 
10 
11 
12 
13 

174 
175 
176 
177 


127 i i 177 


Passuord for user class 33 




The ITEfl REAO/URITE TABLE starts in user label *3 

There are eight uords for each ITEH RERD/URITE bit nap. 

For databases uith nore than 16 itens, the read/urite table continues 

in the next user labels. The specific fomat of this table is explained 

after the SET READ/URITE TABLE since it is defined the sane uay. 

The nunber of user labels occupied by the ITEM REAO/URITE TABLE depends 

on the nunber of data itens defined in the schena and can be obtained 

by rounding upuards (ceiling)the result of: 

Nut-of-labele = [(Hun-of-iten»)*8]/12S 

Since there can only be a naxinun of 255 data itens in the schena, the 
naxinun size for this table in user labels uould be: 

Max-size - [(255)<8]/128 = 15.93 => 16 labels. 


Passuord for user class 34 




124 
125 
126 
127 


Passuord for user class 63 


The PASSUORD TABLE occupies user labels nuntnr 1 md 2. 
There »n four uords (8 characters) reserved for each password. The 
relative position of a password corresponds to the user class nunber 
defined in the schena. for user class nunbers not defined in the 
SOCIB, the four uord field is filled uith blanks. 
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General Rootfile Layout 


General Rootfile Layout 


Itai. Fill- Hirt Mil 


Iten/Set Read/Urite Table Fomat 




LABEL*? 


X 


There are eight uords per iten/set read/urite table definition 
and up to 16 itene/eete per record (user label). Uithin each 8 
uords, the first 4 uords are the flags for the user classes uhich 
have read accaee to the iten/set. The second 4 uords tn the 
flaga for the ueer claesee uhich have urite access to the itsn/set. 
The detail fomat for an eight uord field is shoun bslou. 


UORDO 
1 
i 
3 
4 
5 
6 
7 

s 

9 


Setl read/urite bit nap 



1 
2 
3 
4 
5 
6 

7 
10 

11 




A. Four uords for read access: 

15 16 31 32 47 48 63 

1 uord 1 t uord 2 I uord 3 I uord 4 I 


Set2 read/urite bit nap 


15 




17 
20 


4 uords represent 64 bits. Bit n represents read access for user 
class n to the iten/set. If bit n is set to 1 then user class n has 
read access to the iten/set. 
For exanple, if the uord settings are: 


16 


Set3 read/urite bit nap 




uord 1 uord 2 uord 3 uord 4 
Z000016 Z020000 1000410 Z00130O 


119 




167 
170 
171 


This neans that user classes 12, 13, 14, 18, 39, 44, 54, 56 and 67 
have read access to the iten/set. 

If no read/urite security is defined at all for the iten/eet, then 
all of the read security bits are set to 1. 


120 
121 


Set16 read/urite bit nap 


127 




177 


B. four uords for urite access: 








I uord 1 

Urite ac 
Bit n n 
bit n if 
For exar 


15 16 31 32 47 48 63 


The SET RERD/URITE TABLE starts on a user label boundary after the 

ITEtl RERD/URITE TABLE. 

There are eight uords for each SET REAO/URITE bit nap. 

For databases uith nore than 16 data sets, the read/urite table 

continues in the next user labels. 

The specific fomat of this table is shown in the next page. 


I uord 2 I uord 3 l uord 4 I 


cess flags have the sane fomat as the read access flags, 
presents urite access for user class n to the iten/set. If 
set to 1, then user class n has urite access to the iten/eet 
pie, if the uord eettings are: 


The nunber of user labels occupied by the SET READ/URITE TABLE depends 
in the nunber of data sets defined in the schena, and is obtained by 
rounding upuards (ceiling) the result of: 

Run-of-labele » t(Nun-of-sets)«8)/128 

Since there can only be a naxinun of 99 data sets defined in the schena 
the naxinun size for this table in user labels is: 


uord 1 uord 2 uord 3 uord 4 
£000010 Z020000 ZOOOOOO Z001100 

This neans that the user classes 12, 18, 54 and 57 have urite access 

to the iten/iet. 

If no read/urite security is defined at all for the iten/set, then 

all of the urite security bits are set to 0. 


flax-size < [(9»)««]/12l > 6.1! •> 7 labels 
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RECORD #0 




word 


RDOT'DBSTRTUS 

ROOT'uBNME 




1 
2 
3 
4 




5 


ROOT'TRUiLSTH 
"ROOT'BUFFLGTH 
ROOT'LGTH 


(trailer area lenqth) 1 


6 


(buffer lenqth) I 


7 


(rootfile length) 


3 


ROOT'ITEIICT 
"RDOT'SETCT 

ROOT'ITEBPTR 
"ROOT'DSETPTR 
"RESERVED 


(nunber of itens) 1 


9 


(nunber of data sets) i 


10 


(iten table pointer) 1 


11 


(set table pointer) 1 


12 
13 

14 
15 


(set to blanks) 


16 


NOUOPEH i 


17 


nflXOPEH i 


18 


RESERVED 


(for future use) 1 



(set to binary Qs) 



Central Rootfilt Layout 



127 L 



_l 177 



RDOT'DBSTRTUS 

(0:8) - ItlAGE version ('B ] in ASCII) 
(8:8) - Binary 1 (filler) 

ROOT'DBNAflE - DATABASE nane left justified (last 2 chars are blank). 

NOUOPEN - Nunber of data sets opened. This field is not used in IIWGE B 

HflXDPEN - flaxinun nunber of data sets that can be opened. This field is 
not used in IHBGE B. 

NOTE: 

ROOFITEHPTR and ROOT'DSETPTR is a word offset fron record (be- 
ginning of the file, not including the space taken by the user la- 
bels) and can span several records. 

These pointers point to the Oth entry of the table and since the 
Oth entry in the iten table or the set table does not really 
exist, they actually point to 11 words before the beginning of the 
table. To get to the first entry in the table, this pointer should 
be increnented by the length of the entry (which is currently 11 
words). 
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Central Rootfilt Layout 
Root File Rtcord 1 



bits/ 
word 


_0:.1:J:J:_4:_5:_6:_7 

iten-nane-1 


_8:_9:10:11:12:13:14:15 


Z 



2 

3 
4 
S 
6 
7 






2 
3 
4 
S 
6 
7 


8 


_iteti-no-of-synonyn 

~reserved-2 

subiten-count 

iten-nane-2 


reserved-1 


10 


9 


iten-type 


11 


10 


subiten-lenqth 


12 


11 
12 
13 
14 
15 
16 
17 
18 




13 
14 
15 
16 
17 
20 
21 
22 


19 


_iten-no-of-synonyn 

reserved-2 
subiten-count 


reserved-1 


23 


20 


iten-tvoe 


24 


21 


subiten-lenqth 


25 


22 




26 



The ITEH TABLE starts in record #1. 

Each entry is 11 words long and the length of the table depends on the 
nunber of data itens defined in the schena. The relative position of 
an iten definition depends on its relative position in the schena. 

Iten-nane: is a data iten nane, left-justified and uith trailing blanks 

Iten-nunber-of-synonyn: is the nunber of the iten whose nam has the 
sane hashed result as this one (this is 
utilized for quick iten nana searches). 

Iten-type: is one of the follouing: I, J, K, R, X, U, Z, or P 

iten-type 
I 
VALUES, 20J2; 

j I subiten- length 
j subiten-count 

The naxinun size for this table is 11*255 = 2805ud3 



The reserved-1 and reserved-2 fields are the 'old' level nunbers 
for read and write security. Now, the values are always zero. 
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General Rootfile Layout 



Root . File- Next Record 



bits/ 

word 

1 

2 

3 
4 
5 
6 
7 


0: 1: 2: 3: 4: 5: 6: 7: 8: 9:10:11:12:13:14:15 
set-nane-1 


r 



1 

2 
3 
4 
5 
6 
7 


! 


set-no-of-synonyn I reserved-1 


10 


9 


reserved-2 1 data-set-type 


11 


10 


DSCB-pointer 


12 


11 
12 
13 
14 
15 
16 
17 
18 


set-nane-2 


13 
14 
15 
16 
17 
20 
21 
22 


19 


set-no-of-synonyn 1 reserved-1 


23 


20 


reserved-2 I data-set-type 


24 


21 


DSCB-pointer 


25 


22 




26 



Data Set Control Blocks (DSCB)- General Layout 



DATA SET GLQ8RL AREA (set 1) ' 

(capacity, lengths, counts, etc.) 



RECORD DEFINITION TABLE (set 1) 

a. ITEH NUflBERS 

b. ITEH DISPLflCEIIENT 



fieldcount*2+2 



PRTH TABLE TseVlT 

(search iten, sort iten, etc.) 



pathcount*2 



DATA SET GLOBAL AREA (set 2) 

(capacity, lengths, counts, etc) 



Set table follows the Iten table. 

Each entry is 11 words long. The length of the table depends on the 
nunber of data sets defined in the schena. The relative position of a 
set definition depends on its relative position in the schena. 

Set-nane: is a data set nane, left-justified and uith trailing blanks. 

Set-nunber-of-synonyn: is the nunber of a data set whose nane has the 
sane hashed result as this one (this is utilized 
for quick set nane searches). 

Data-set-type is one of the following: A, H or D. 

DSCB-pointer: is a pointer to the Data Set Control Block. This 
pointer is word offset fron record 410. The DSCB is 
described ahead. 



The naxinun size for this table is 11*99 = 1039wds. 



The reserved-1 and reserved-2 fields art the 'old' level 
nunbers for the read and write access respectively. Since 
this concept no longer applies, the values art set to zero. 
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RECORD DEFINITION TABLE (set 2) 

a. ITEfl HUflBERS 

b. ITEfl DISPLACEI1ENT 



fieldcount*2+2 



"PATH TABLE Taet~27 

(search iten, sort iten, etc.) 



pathcount*2 



DATA SET GLOBAL AREA (last set) 

(capacity, lengths, counts, etc) 



30 wds. 



'RECORD DEFINITION'TABLE (last set7 

a. ITEI1 NUtlBERS 

b. ITEP. DISPLflCEIIENT 

fieldcount*2+2 



"PATH TABLE fllst set) 

(search iten, sort iten, etc.) 



pathcount*2 



DSCB 
setl 



DSCB 
set2 



DSCB 
last set 



The DSCBs follou the SET TABLE in the Root File. 

There is one DSCB for each data set defined. The function of the DSCB 

is to define each data set within the data base. 
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Data Set Control Block (Blofaal fln.) 



bit/ 
word 
1 
2 
3 
4 
S 
6 
? 
8 
9 

10 
11 
12 



0: 1: 2: 3: 4 
"OSCBP 


J:_6:_7:_8:_9:10:11:12:13:14:15 
(data tat capacity) 


"OSIKDIBLGTH 

~0SEh7R*LGTH 

"OSBLOCKFBC 

DSPBTHCT 

JSMITHPTR 

"logical end o 


(block length) 


(nedia rtcord lengtni 


(entry lentittit 


1 DSFIF.LMT 


1 Kl DSPRIItKEY 


(offset to oath tabla) 


file 


tux nuti of records in Ift 


18 words of binary zeros I 



General Rootfilt layout 



I 


1 
2 
3 
4 
5 
S 
? 

10 
11 
12 
13 
14 



29 |_ 
BSCW 

DSBLOCKLGTH - 
DSIKDHLGTH - 

DSEHTRYLGTH ■ 
DSBUOCKFDC • 
DSFIEIDCT ■ 

DSPRTHCT 

H-DSKEYTWE ■ 

OSMMKEY ■ 



-I 35 



• data tet capacity a» reporttd by the SCHEhfl processor. 

- data set block length including the bit nap overhead. 

- data act nedia record length (renenber that this length 
includes the pointer overhead) 

■ data set entry length. 

- data set blocking factor. 

- data set field count. This is the nunber of fields 
specified for the data set. 

• data set path count. This is the nunber of paths that are 
specified for the data set. 

• data set key type. If OSKEYTYPE • TRUE then 
the key is hashed. 

■ data act prinary path or key. 

For nastar data seta, this is the field nunber of the 
search iten. 

For detail data sets, this is the field nunber of the 
prinary path. 

- data set path table pointer. Uord offset to the data set 
path table uhich contains an entry for each path defined. 
It points to path Oth entry in the table, so to get to 
the first entry the pointer should be increnented by the 
length of the entry (uhich is currently 2 words). 
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General Rootf ila Layout 



Data Sat Control Hock (Ittn Hunters) 



_0:_1sJ:J:_4:_S: fc 7:J:_9:10:11:12:13:14:1S 

wrd QteH_nun^oO*t_ f iaid*_l~it«n_nun - of_2nd - field_| 

1 j iten nun of~3rd field Tate. I 

. Cetc." - - - • — 



ij3inary_0_ 



JJunary 0_ 
~'„binary_0_ 



The Iten Hunters Tabla follous the Global Urea of the DSCB. 
The size of this tabic (in words) is equal to the nunber of itans in 
the given data set plus 1. The first n bytea are used to ctrry the iten 
nunbera of the fields uithin the data set. The renaining nt2 bytes *rt 
sat to binary zeros. 



Data Set Control Block (Record Definition Iten Disolacenent) 



_0i_1:_2:_3:.4:_5:_6:_7:_B:_9: 10:11:12:13: 14:15 
uord |~uord_offset3oIfirst_field7 



1 i uord offset to second field 

2 |"uonfoffseOo_third_field_ 



|_uord_offset.to_last.field_ 
|_iength_of_entry 



This table imediately follous the Iten hunters Table. 

The uord offset points to the starting location of the field uithin the 
nedia record. Renenber that the nedia record includes the pointer over- 
head so this offset varies for naster and detail data sets: if a naster 
data set has only one path, the uord offset for the first field is 10, 
since there art 10 words of overhead— 5 uords for the synonyn chain 
pointers and 5 uords for the data set chain head that it uould be point- 
ing to. On a detail data set uith one path, the overhead is only 4 
uords. 

The 'length-of-entry' field is the sane as the nedia record length. 
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Gtntril Igetfllt layout 



tilt ill Caml.ilMHf'itil Tlilll 



uord 
1 
8 
3 
4 



JB:.1:.t!j: 4:J:.I:.7:.I:.»:W:11:1!:13!M:1! 

1st path definition 



Central Rootfilt Layout 



Rteord 



_RK0RD through n_ 




data rtcord* 



There art 2 uords (4 bytes) For each path definition. 

The PATH TRBLE for natter data sttt has a different layout from the 

MTH TRBLE for detail data sets. 

Hatter sets: 

Byte Description 

1 - iten nunber of the search iten in the related 

detail set. 

2 - iten nunber of the sort iten in the related 

detail set. 

3 - set nunber of the related detail data ttt 

4 - path nunber of the corresponding path in 

the related detail data tet. 

Detail aett: 
Byte Description 

1 - field nunber of the starch iten. 

2 - field nunber of the sort iten. 

3 - set nunber of the related naster data act 

4 - path nunber of the corresponding path in 

the related naster data set. 



Genera^ Data Set layout 
USER LABEL 



0-1 1 netters*capacity 
I details*highuettr nark 



L 

Uord 2-31 



I nunber of unused records 

I. 



4-51 natters" not used 

Idttailt' delate chain head 



Rtcord n 



Ms to v>ir i*t«i 9 



Uord 0-1: Record nant of the highest readable record. 
For natttrt, this is the highest record in 
the set (i.t. Capacity). For Details, 
this is the greatest nunber of records that 
have been written to the tet thus far. For 
exanple, if there it roon in the Detail data 
set for 100 records and 75 Here written last 
ueek when the data set was loaded uith 
DBLORD, and yesterday 15 records utre deleted 
fron the data tet, the "High Uater nark" 
it equal to a value of '75. 

Uord 2-3: Hunbtr of unuttd rtcords in the data ttt. Thit 
fitld it increnented uhen a record is deleted 
and decrcnanted uhen a record is added. To 
detemine the current nunber of entrist uted 
in the ttt subtract Uord 1-2 (unuttd count) fron 
Uord 0-1 (capacity). 

Uord 4-5: The dtlttt chain htad for Details. This points 
to tht rtcord nott recently deleted or contains 
a value of zero if no records have been deleted. 
Thit field is not uted in Raster data sets. 



Data Set Rtcordt 



The data in the data ttt rtcords is arranged according to 
the Htdie rtcordt. Thtte art fometted by the Schena 
Processor (DBSCHEIffi). 



0.01.00 
21- 15 



G.01.00 
21- 16 



Disc Fret Space 



CHAPTER 22 DISC FREE SPACE HAP 
Disc Resident Data Structures 



There are tuo disc resident free space data structures, the bit nap and the 
descriptor table, for each disc volune that has a free space nap, i.e. systen 
discs and private volunes. The addresses of these data structures are kept 
in the disc label. The syribols that define the descriptor table and bit nap 
art in the include file INCLDFS2. 



Bit , . lap 



The bit nap is divided up into pages, uhich is the physical block of the nap 
that is read or written, fit the nonent, a page is defined to be one sector 
(128 uords) long, this nay be changed by changing a conpile tine constant. 
The last uord of the page is a checksun for that page, all other uords are 
data. There is a one to one correspondence between bits in the nap and sec- 
tors of the disc, A one bit represents a free sector and a zero bit 
represents an allocated sector. The bit nap is a contiguous set of pages, 
enough to represent the entire disc, excluding spare tracks and spare 
sectors. 



Descriptor Table (DT) 



The descriptor table is an array of three word entries, one entry for each 
page of the bit nap. Each entry looks like this: 



uord - largest space - 
uord 1 - starting space = 
uord 2 = ending space = 
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Disc Free Space 

Thus the descriptor table looks like this. 



= entry for page 

- entry for page 1 

= entry for page 2 

= entry fof page 3 



entry for last page 



Each entry describes the free space on the corresponding page of the bit nap. 
The largest 'space word is the size of the largest contiguous block of free 
space on the page, uhich is not at the very beginning or very end of the 
page. That is, the first bit physically representing the space is not the 
first bit of data on the page or the last bit representing the space is not 
the last bit of data on the page. Starting space is the nunber sectors of 
contiguous space represented by the set of bits uhose first bit is the first 
bit of data on the page. Ending space is the nunber of sectors of contiguous 
space represented by the set of bits uhose last bit is the last bit of data 
on the page. The starting space and ending space fields allow looking across 
page boundaries, thus preventing fragnentation on page boundaries. Thus, if 
all sectors represented on a page are free, then starting and ending space 
uill be the sane and have the total nunber of free sectors represented on the 
page. Largest space uill be zero, as there is no block of space that is not 
at the beginning or end of the page, ft value of - 1 for all the fields in an 
entry indicates the corresponding page is bad, either fron a checksun or I/O 
error. 



Virtual flenorv Resident Data Structures 



For each systen disc or physically nounted private volune there is a data 
segnent uhich has infomation about the disc free space nap, the current copy 
of the descriptor table, sone work space for the procedures while in split 
stack node and buffers for pages of the bitnap. The DST nunber of the data 
segnent for a given disc is found in the LDTX entry for that disc. 

Disc Free Space Data Segnent 

For each systen disc or physically mounted private volune in the up and run- 
ning systen there is a DST uhich contains infomation about the disc free 
space nap for that disc, sone uork area, a copy of the descriptor table and 
buffers for the pages of the bit nap. 
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Disc Free Space 



All synbols that define these data segnents are in the include file INCLDFS1 , 
and they are prefixed with "ds" 1 . The structure of the data segnent is as 
follous: 



Disc Free Space 



o (a» = 


ds'ldev 


= 


1 (zu = 


ds'dst 


■ 


2 (Z2) ■ 




= 


3 (SO) - 




' 


* (Z4) • 


ds'last'page'of'nap 


= 


5 (Z5) = 


ds' last ' buff er' index 


= 


6 (Z6) = 




» 


7 (Z7) = 




■ 


8 (Z10) = 


ds'lock 


• 


9 (Z11) = 


ds'lock'count 


= 


10 (112) = 


ds'queue'head 


■ 


11 (Z13) = 


ds' queue' tail 


= 


12 (Z14) = 


ds'descriptor' table 


■ 


13 (Z15) = 


ds' buffer' page' nunber 


■ 


14 (Z16) = 


ds'buffer' dirty 


■ 


15 (Z17) = 


ds'buffer'area 


= 


16 (Z18) = 


ds' first' threshold' page 


= 


17 (Z21) = 
1! (Z22) = 


ds' size' of ' last' allocation 


--= 



19 (Z23) 


- 


ds' last 'page' allocated' fron 


• 


» (Z24) 


• 


ds'next' buffer' index 


= 


21 (Z25) 


= 


ds'page'nunber 


= 


22 (Z26) 


= 


ds'uord'nunber 


= 


23 (Z27) 


= 


ds' bit 'nunber 


= 


24 (Z30) 


= 


ds 1 page 'pointer 


= 


25 (Z31) 


■ 


ds'starting'uord' nunber 


= 


25 (Z32) 


= 


ds' starting' bit'nunber 


■ 


27 (Z33) 


= 




= 


28 (Z34) 


= 




= 


29 (Z35) 


- 


ds' bit 'count 


= 


30 (Z36) 


■ 


ds'entry'type 


= 


31 (Z37) 


= 


ds'buffer' index 


= 


32 (MO) 


= 




= 


33 (Z41) 


■ 




= 


34 (Z42) 


= 


ds'error'status 


= 



The rest of the data segnent contains tables uhose size and location is 
dependent on the size of the disc and or the nunber of buffers in the data 
segnent. They are shoun belou just to denonstrate there relation to one 
another, for there actual location, the pointers should be exanined. The 
synbol "ds'array'area" defines the start of the area. The first table is the 
descriptor table, it is in the sane fomat as the disc copy, but a dunny 
entry of all zeros is added before and after the table, these are needed by 
procedures "Find'Page" and "Build'Descriptor'Entry". The pointer to this 
table is "ds'descriptor'table", it points to the entry for page zero, not the 
dunny entry. 
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Disc Free Spice 

« 

s . — .......i tiunny 

■ ■ 

■„ — 1 tntry 

■ ■ 

■ largest space * 

■ ■ trv try for 

■ starting space ■ 

■ -— - - ■ page 

* ending space ■ 

* largest space ■ 

a ■ tn try for 

* starting apace ■ 

>._ . a pi g, 1 

' ending space * 

UtllllllllMtUIUIIIiniUIBlIUt 

* largest space « 

e * . » tntry for 

» ftarting tpact * 

. • | l¥t pigt 

■ ending apace * 

B o . 

a..-..— ................... ....... s dunny 

■ o ■ 

s . a tntry 

* ■ 

aaaaaaEaaaaaxaaaaastaaaaaaaaasaasaa 

The next table la ds'buffer'paga'nunber table, it hat a one uord entry for 
each buffer in the data segnent. Sach entry containa the page nunber of the 
page currently in the corresponding buffer or '1 if the buffer it enpty. 
Thia ie pointed to by "da'buffer'page'nunber". 

■a a aea aaa sa aaa a aa a* ass taxaa aa a a as *a 

■ buffer entry ■ 

■ ■■IIIIUKIXSIIHItllllKtlimiH 

1 buffer t entry ■ 



3 last buffer entry • 

ZBZBBXECBZZZBXZBXZEXaZZXXBXXaBXXaBB 
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The next table it the ds'buffer'dirty table, which hat a one uord entry for 
each buffer, fl TRUE indicates the page in the corresponding buffer is dirty, 
i.e. the disc eopy is not up-to-date, fl FRLSE indicates that the buffer ie 
clean. If OFS uae cenpiled uith dirty buffer nanagenent turned off, this 
table is not pressnt and the de'buffer'dirty pointer is zero. 



■ buffer entry ■ 

BBflBBBBBBBBBBBBBflBBBBBBBflBBBBBBBBBB 

■ buffer 1 entry » 

BBBBBBBBBBBBBflBBBBBBBBBBflBSBBBBBBBB 



■iiRiutiiiiitiniiiiuintHiiiiii 

■ last buffsr entry ■ 

lltHIIIIIIItllllMIIIIIItlllllllll 



The renainder of the data segnent contains the buffers, each buffer is the 
size of one page of the bit nap, which is currently one scetor(128 words). 
The beginning of the buffer area is pointsd to by "ds* buff er' area" and the 
nunber of buffers is the value in "dt'laat'buffer'index" plus one. 
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Each of the fields of the data segnent is described in the include file 
IKCLDFS1, where they are defined. It should be noted that the following 
fields are just workspace, used to pass infomation between procedures uhile 
in split stack node and have no waning between calls to the disc free space 
nanagenent subsystem 



ds'page'nunber 
ds'bit'nunber 
ds'starting'word' nunber 
ds' nunber' of ' sectors 
ds'bit'count 
ds'disc'address 



ds' word' nunber 
ds'page'ptr 
ds'starting'bit' nunber 
ds' entry' type 
ds'buffer' index 



The field ds'error'status noraally has no Meaning between calls unless the 
error'type field has a value greater than "fatal'dfs'error", in uhich case it 
neans that disc space nay no longer be allocated on this disc. 
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CHRPTER 23 HPE DISC CACHINQ 



Disc Caching OvervJ.ffu 



Disc Caching is an optional feature of HPE that utilizes excess tiain nenory 
*nti excess CPU horsepower to keep portions of frequently referenced disc 
"donains" in nenory. (fl disc "donain" is a copy of a portion of disc resid- 
ing in nain nenory. These disc donains are considered "cached" when they are 
in nenory and are considered "napped" when there is I/O pending against 
then.) Disc Caching nanages the bi-directional transfer of these disc 
donains between nain nenory and disc storage. No nain nenory is permanently 
dedicated to cached disc donains. Cached disc donains share nain nenory uith 
all other types of HPE segnents and an not treated differently by the nenory 
nanager. By keeping cached disc donains in nenory, a significant portion of 
the references to disc storage can be resolved without actually having to 
physically access the disc. Disc Caching policies are integrated into the 
HPE Kernel, File Systen, and I/O System which allows the system performance 
to be tuned based on the current workload and resource availability. 

Disc Caching uses the HPE kernel resource management nechanisns and 
strategies. These nechanisns are extended to handle cached disc donains in 
the sane nanner as segnents. Thus, cached disc donains can be of variable 
size, fetched in parallel with other segnents or cached domains, garbage col- 
lected, and replaced in the sane nanner as stacks, data and code segnents. 
The relative use of nain nenory betueen stacks, data and code segnents, and 
cached disc donains is dynanic. This partitioning is based on the workload'* 
current requirements and current nenory availability. 

Disc Caching can be enabled/disabled on a disc by disc basis. When caching is 
enabled for the first disc, the code segnent containing the Disc Caching code 
will be locked into nenory. Also at this tine the Cache Directory Table (CDT) 
will be built and locked into nenory. Uhen caching is disabled for the last 
disc, the code segnent will be unlocked fron nenory and the CDT will be 
released. Thus if caching is not enabled no nenory will be wasted. 

The CDT is used to keep track of the following information: 

1) The disc ldevs currently enabled for caching. There uill be a 

Device Entry in the table for each cached disc. 

2) fl linked list of cached donains for each disc uith caching en- 

abled. The head and tail of this linked list will be contained 
in the Device Entry. (I.e. there is a separate linked list of 
cached donains for each cached disc ldev. ) 

3) The cached donains that currently have user I/O pending (i.e. 

FREADS/FURITES) or have nenory nanagenent I/O pending (i.e. 
fetching the disc donain into nenory, or posting the disc 
donain back out to disc). There will be a Flapped Donain Entry 
in the table for each disc donain has that I/O pending and is 
thus "napped". 
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4) fl linked list of all user I/O pending against the napped disc 
donains. There uill be a Logical Disc Request (LDR) queued to 
the Happed Donain entries that uill describe the user I/O to 
take place. This is analogous to a Disc Request queued to a 
specific DIT uaiting for service. 

Uhen a request is nade to access disc infornation, Disc Caching nust first 
determine if the requested disc donain is present in nenory. Disc Caching 
will first deternine if the requested area of disc is already napped into 
nemory by scanning through the Flapped Donain entries of the CDT. If the 
requested transfer can be satisfied uith a currently napped disc donain, then 
the I/O request uill be queued (FIFO) behind the other I/Os pending against 
that napped donain. If the requested area is not already napped, then a 
search is nade through the linked list of cached disc donains for the 
specified disc ldev. (The region header contains the disc address and size 
that a disc donain represents.) If the requested donain is found in this 
list (i.e. present in nenory), then this region uill be napped, fl donain is 
then considered napped uhen there is an entry for it in the Flapped Donain 
portion of the CDT. Flapping the domain allows Disc Caching to nanage the I/O 
pending and/or currently active for a particular disc donain. Once the disc 
donain is napped and present, the data can be noved betueen the process' data 
area and the napped disc donain. The process can then continue executing 
without interruption or a process switch. The user/subsysten process for 
uhich the nove is done uill be charged uith the CPU overhead. 

Uhen a request is nade to read data that is not currently cached in nenory 
(i.e. a read "miss"), the fetch strategy uses the File System's knowledge of 
the type of access (sequential or randon), the extent size of the file, along 
uith the current nenory load to select the optinal size of the disc donain to 
be fetched and napped into nenory. The fetch of the disc donain is then in- 
itiated on the user's stack without a process switch. After the fetch is in- 
itiated, it conpletes in an unblocked nanner so that this process (if no-wait 
I/O) or another process can proceed in parallel with the cache fetch. 

In general, uhen writing, a process will not wait for conpletion of the 
physical I/O. Instead, the process will be awakened as soon as the transfer 
has conpleted betueen the process's data area and the napped disc donain 
(i.e. no-wait-for-post). The physical I/O uill then be posted at background 
priority while the process continues. (Users can specify uait-for-post on a 
file by file basis in place of the default no-uait-for-post uith the FSETF10DE 
intrinsic. This can be done on a global basis via :CflCHECQNTROL.) If the 
access request is a urite and there is a current write pending against the 
specified napped disc donain, the process request is queued until the pending 
urite is posted to disc. If the disc domain to be written is not currently 
cached in nenory, a free piece of nenory will be obtained to nap the cor- 
responding disc inage and then the "write" takes place fron the process' data 
area to the napped disc donain. This prevents data fron having to be read 
before being uritten. After that, a post to disc is initiated (on any urite 
only the portion of a napped disc donain that is nodified uill be posted to 
disc). After the nove to the napped disc donain is complete and the post to 
disc is initiated, the process performing the "urite" is alloued to continue 
to run without having to uait for the post to complete, writes that nust be 
posted to disc in a certain order use the Global Serial Urite Queue. These 
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ordered writes include things like updating disc free space naps for a new 
file extent before updating the file extent nap in the file label. 

There are two disc request entries used for disc caching requests. The first 
entry is a Logical Disc Request (LDR) entry and is used to nanage the data 
noves to/fron the user's data area and the disc donain (i.e. the logical 
I/O). The second entry is a regular Disc Request (DRQ) entry and is used to 
perform the physical I/O necessary to nap a disc donain (for a read "niss") 
or to perforn the physical post (on urite requests). The disc donain uill 
renain napped until both the logical and physical I/O conpletes. If a request 
is not conpletely described by one disc donain already in nenory or a flapped 
Donain CDT entry (i.e. the requested disc area falls into nore than one disc 
donain) then the overlapping disc donain(s) uill be flushed to disc and the 
new complete disc donain uill be fetched (if read) and napped - no partial 
nappings are alloued. 

The DST nunber of the Cache Directory Table (CDT) is at X12?3 and the bank 
and offset are kept in X1274-X1275. The Caching Sir (2) is used uhen starting 
and stopping caching (via :STflRTCflCHE/:STOPCflCHE) and by the LOADER uhen 
loading a progran file (this sir is only used uhen updating the STT at load 
tine). 

Uhen caching is enabled for a disc, a bit in the flags word of the DIT is 
set. Also, the Global Serial Urite queue can be found by examining the 
header entry of the Disc Request Table. See Chapter 13 for a nore detailed 
explanation of both the DIT and the Disc Request Table header. See Chapter 2 
for a description of the F1enory Region Header for a disc donain (cached 
region). 
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Cache Directory Table 



The Cache Directory Table (COT) is the bookkeeping structure for naneging 
cached disc donaina. This tabls is divided into 3 parts: 

JDT Header Entry 

This sntry contains all information necessary to nanage the entire table and 

alto contains global caching related information. 

COT Device Cntry 

There will bi one of these entriet for every diec ldtv that currently hat 
caching enabled. These entries keep track of all cached disc doriains in 
nenory for this device. In addition, these entries contein etatietics regard- 
ing the nunber of I/Os performed to the ldtv. 

CDT napped Donain Entry 

These entriet describe disc domains that are currently "napped" into nenory. 
This neans that there it logical I/O (cache nove) and/or physical I/O (fetch 
or post) pending. Thett tntritt ktep track of the etate of the cached diec 
donain (MI, ROC, etc.) jutt at the DST Tablt kttpt track of data ttgntntt. 



The following log core cells contain the tddreat of the COT: 

11273 contains the DST Nunber of the CDT 

11274 contains ths Sank Nunber of the COT 

J! 275 contains the Of feet uithin the bank of the COT 
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Header Entry 







# Entries 


COT 'ENTRIES 


1 


Entry Size <I») 


COT 'SIZE 


2 


* Free Entries 


COT 'FREE 'COUNT 


3 


1st Free Entry (table offset) 


COT 'FREE 'HERD 


4 


Last Free Entry (table offset) 


COT'FREE'TRIL 


5 


hex It Entries Used 


CDT'flRX'USEO 


6 


11 Ldevs cached 


COT 'NUII' LDEVS 


7 


1st Cache device entry (entry nunber) 


CDT 'DISC HERO 


Z10 


* Uords this DST 


CDT'OST'UORDS 


111 


TRUE if stopcache pending 


CDT'STOP'PND 


112 


11 Sectors sequential fetch 


CDT'SEQ'tllNFTCH 


X13 


1* Sectors randan fetch 


CDT'RND'MNFTCH 


114 


TRUE if uait for physical post 


CDT 'FORCE 'POST 


Z15 


Head of inpeded queue (PIH) 


COT'STOP'QUEUE 


116 
Z27 


' 





Disc Caching 



CDT'ENTRIES 

The total nunber of CDT entries configured in this table (i.e. includes all 
three types of entries). The nunber of entries in the table uill be: 
1 entry for the header 
+ 1 entry for each disc ldev configured. 

(CDT Device entries) 
+ 1 entry for each DRQ configured. 
(CDT Happed Donain entries) 

This schene insures that this table can never overflow (since an entry in the 
DRQ table is aluays obtained before an entry in this table). 

CDT* SIZE 

Size of each entry in the table. 

CDF FREE 'COUHT 

Total nunber of entries currently unassigned. 

CDT' FREE' HERD 

Table relative offset (i.e. Entry nunber * entry size) of the first available 

entry. 

CDT'FREE'TfilL 

Table relative offset of the last available entry. 

CDT' ilBX' USED 

The naxinun nunber of entries in use at one tine. 

CDT'MUfl'LDEVS 

The nunber of ldevs currently cached. 

CDT'DISC'HEflD 

The entry nunber of the first Device Entry, 

CDT'DST'HORDS 

The total nunber of uords in this data segnent. 

CDT'STOP'PND 

This value uill be TRUE if there is a pending :STQPCRCHE. 

CDT'SEQ'MNFTCH 

If there is a prefetch for a sequential read ("niss"), the size of the 
prefetch is delinited by the extent size of the file. Uithin this linita- 
tion, the prefetch is equal to the greater of tuo sizes: 

1) Requested size. 

2) The largest integer nultiple of the request size that is snaller 
than the value found in this cell. 

The default value is 96 sectors. (This value nay be changed via 
:CfiCHECONTRuL). 

CDT'RHD'MNFTCH 

This is th« i#«e 99 CDT'SEQ'HTNFTCH except that if 1 fo<" nnijoM §<;?•«•, tk* 

default value is 16 sectors. (This value my be changed via :CPCHECDNTRQL), 
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CDT 'FORCE 'POST 


Device Entrv 


Uhen this value it TRUE, all writes uill "block" until the physical update on 




disc completes. The systen default is FALSE. (Can be altered via 




:CRCHECONTRQL). 












| Next ldev entry (entry nunber) 


CDT'DE'NEXT'LDEV 


CDT'STOP'QUEUE 








If CDT' STOP' PENDING it TRUE this uill be the PIN nunber of the head pin of 


1 j Prev ldev entry (entry nunber) 


CDT 'DE* PREV' LDEV 


the processes iripeded until the : STOPCflCHE conpletes. 










2 | Ldev for this disc 


CDT 'DE' LDEV 

CDT'DE'nflPD'PRGES 

CDT'DE'nftPD'CNT 

CDT 'DE'tlflPD' HERD 

CDT'DE'nRPD'TRIL 

CDT 'DE' REGIONS 

CDT'DE'REG'HD 




3 j # Pages in device's donain 




4 j # Disc donains currently napped 




5 j Head of napped donain (entry nunber) 




6 j Tail of napped donain (entry nunber) 




7 j N (Use donain regions for this device 




210 j nenory address of head 




j cached disc donain 


CDT'DE'REG'TL 




212 j Nenory address of tail 




I cached disc donain 


CDT'DE'RHIT 




X14 | 




I- # Read hits 


CDT'DE'UHIT 




Z16 | 




I- # Write hits 


CDT'DE'RHISS 




Z20 I 




j- # Read nisses 


CDT'DE'UniSS 




Z22 I 




j- # Urite nisses 


CDT'DE'STOP 




124 | 




I- # Stops 


CDT'DE'SCANPT 




X26 | nenory address of last 




t referenced donain 
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CDT'DE'NEXT'LDEV 


CDT'DE'RHISS 


The entry nunber of the next Device Entry. 


Total nunber of tines that a read uas requested and the requested disc donain 




uas not in nenory - i.e. a read "niss". This neans that the requested disc 


CDT'DE'PREV'LDEV 


donain had to be fetched into nenory before the read could conplete - thus 


The entry nunber of the previous Device Entry. 


potentially blocking the process. This value uill reset to zero on overflou. 


CDT 'DE' LDEV 


CDT'DE'UniSS 


The Ldev nunber for this cached device. 


Total nunber of tines that a urite uas requested and the requested disc 




donain uas not in nenory - i.e. a urite "niss". This does not nean that the 


CDT'DE'tfflPD'PRGES 


process uould block until the disc donain is fetched as is the case for 


Total nunber of nain nenory pages allocated to disc donains for this cached 


reads. Rather, a free nenory region uould be obtained to be the destination 


device. This includes napped and unnapped regions. (1 nain nenory page = 128 


of the cache nove. This disc donain uould then be posted in the background 


uords). 


(unless overridden via iCftCHECQNTROL or FSETH0DE) allowing the process to 




continue without blocking. This value uill reset to zero on overflou. 


CDT'DE'hWCNT 




The total nunber of Flapped Donain entries associated uith this Device Entry. 


CDT'DE'STOP 




Total nunber of tines that a process had to block on a cache transfer. Uill 


CDT'DE'nflPD'HEflD 


reset to zero on overflou. 


The entry nunber of the first Happed Donain entry for this device. 






CDT'DE'SCHNPT 


CDT'DE'nBPD'TRIL 


The nenory address of the last region looked at on a search. This address 


The entry nunber of the last napped Donain entry for this device. 


uill be of the next donain (ND) field of the region header. This value uill 




be used along uith CDT'DE'REG'HD to deternine uhere to start the next search 


CDT' DE' REGIONS 


for a cached disc donain Rt tines it uill be nore efficient to start uith 


The total nunber of disc donain regions for this ldev (includes napped and 


this address since the disc donain requested nay be of a higher disc address 


unnapped regions). 


than found in this region header, rather than always starting the search uith 




CDT'DE'REG'HD. 


CDT'DE'REG'HD 




nenory address to the head region of the disc dpnain linked list. Disc donain 




regions *n linked in order based en the disc address they represent (i.e. 




snail disc address at head, large disc address at tail). This address uill 




not point to the region base (RB), but to the next donain (ND) field of the 




region header. (This is to facilitate the use of the LLSH instruction). 




CDT'DE'REG'TL 




nenory address of the tail region of the disc donain linked list. This ad- 




dress uill be of the previous donain (PD) field of the region header. 




CDT'DE'RHIT 




Total nunber of tines that a read was requested and the requested disc donain 




Mas present in nenory - i.e. a read "hit". This neans that the read conpleted 




Hithout perfuming any I/O (to fetch the donain). Thus this is actually the 




nunber of read I/Os elininated. This value uill reset to zero on overflow. 




CDT'DE'UHIT 




Total nunber of tines that a write uas requested and the requested disc 




donain uas present in nenory - i.e. a urite "hit". If there uas no other 




write pending to the "hit" donain, then the process uould continue as soon as 




the cache nove conpletes - thus elininating a block For I/O. Otherwise, the 




process uould block waiting for the first urite to conplete. This value uill 




reset to zero on overflow. 
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BtttaLBiiMinJaia 



I Prtv flipped donain entry (entry nunber) I 

1 I Next napped donain entry (entry nunber)! 



2 I 



7 
XI 
Z11 
112 
Z13 
114 

Z16 
Z17 
120 
Z21 
Z22 

Z23 
I 
I 
I 

Z27 | 



Last sector 
address 



«l II II n 


B| til 111 I 


S| II 01 s 


El 1 1 S 


HI 1 1 


T| 1 1 



LI Fl R| V| H| S| /| 

01 U| 01 II 01 El /| 

CI II CI Rl PI 01 /I 

Kl PI I Gl 0| | /| 

El I I II SI I /I 

01 I I HI T| I /| 



COTWPREV 
CDTTU'HEIfT 

I CDT 'B0 'SECTOR 
-I 

I 
-I 

I COT'IW'EHO'SECTOR 
-I 

I 
-I 

I COT'IWFLHGS 

I 

I 

I 

I 



• Reads pending 

* Uritee pending 

Lock uaiting 

Heed of inpeded LOR 

Heed or active LOR 



Manory address 
if present 



DRO for this napped donain 



« FlutUng CDTe 
Ldev for this napped donain 
Head inpeded queue (PIH) 
Device entry (entry nunber) 



CDT'KO'RERD'CMT 

CDPIKVURITE'CNT 

COT'IIO'UO'COT 

CDT'HO'IIIPED'HO 

CDT'HO'LOR'HEBO 

CDT'nO'HEB'HDR 

CDT'NO'DISCREU 

CDT'MO'LK'CHT 

CDT'IIO'LDEV 

C0T'flO'If1P£DED 

COT'nO'DE 
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1 - READ. Only read LDR(e) are attached. 

2 - URITE. Urite LDR(s) and possibly read LDR(s) are 

attached. 

3 - FLUSH. CDT is being flushed out. 

4 - LOCK. Unused. 



CDT'flD'RERO'CKT 

The nunber of LDRs attached that an for reads (nove not conplete}. 

COT 'HO' URITE 'CHT 

The nunber of LDRs attached that are for urites. HOTE: This count uill not 
be decremented until both the cache nove and the physical urite completes. 
Houever, as soon as the cache nove conpietea, the LOR uill be dequeued fron 
the COT. 

COT'nO'LKD'CDT 
Mot used. 

corno'inPED'HO 

The first LOR that is inpeded. (I.e. the CDT is in a urite state already and 
another urite is attached. The second urite uill be placed in this queue un- 
til the first urite conpletes. ) 

COT BO'LDR' HERO 

The first LOR that is on the active list for this COT. 

COT'nO'nW'RDDR 

The rtenory address (region base) for this napped disc donain, if present. 

CDT'nO'MSCREQ 

The disc request table index associated uith this napped disc donain. This 
uill be used to fetch this region in, or to post this region after any logi- 
cal I/Os (urites) have conpleted. (I.e. this ORQ is used for the physical 
I/O.) 

COT 'HO 'IT CRT 
Hot used. 

corno'LOEV 

The ldev nunber for this napped donain. 

cot'iio'Iupeoeo 

The PIN for the first process inpeded on this napped disc donain. Processes 
get inpeded here uhen they do UHITFORID uhen their LDR is on the CDT inpeded 
queue and the Happed Donain is currently being written out. (This uill also 
happen upon a iSTOPCRCHE to Force all LDRs to conplete.) fls soon as the 

physical post of the Happed Donain is conplete, all processes inpeded here 
uill be auakened. 

COT'nO'DE 

The entry nunber for the Device entry that this flapped Donain entry is as- 
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COT'hU'PREV 

Entry nunber of the previous napped donain entry for this device. 

CDT'dD'HEKT 

Entry nunber of the next napped donain entry For this device. 

COT' nO 'SECTOR 

The starting disc sector address representing this napped donain entry. 

COT'WEHO'SECTOR 

The ending disc sector address representing this napped donain entry. 

CDT'IB'FLRGS 

Flags describing the state of this napped donain entry and the region as- 
sociated uith it: 

(0:1) - Rbsent . 

Region is not present in nenory. 

(1:1) -HI- 

Region is already In-notion-In. (Set uhen the fetch for 
this cached region is initiated). 

(2:1) - IRQ. 

Region is In-tlotion-Out. (Set by STRRTDBJURITE uhen per- 
forming the background post of a cached region). 

0:1) -pa. 

This disc donain uas not present and had to be prefetched. 

(4:1) -LOCK. Not used. 

(5:1) - TO. 

Forced Urite In Progress. Region uas forced out of nenory 
to nake roon for another object. 

(6:1) -Rffi. 

Recover Overlay Candidate. Region nay be forced out of 
nenory to nake roon for another object. Houever, if this 
region it referenced again it can be recovered. 

(7:1) -VIRGIN. 

Clean region in the urite state. Cleared as soon at a nove 
conpletes. (I.e. if this bit is on, then a urite can con- 
plate innediately. Otheruise the urite uill have to uait 
until the current urite conpletee the physical post). 

(8:1) - HOPOST . 

Set uhen the CDT is being posted out as a result of a 
urite request that did not uant to uait for the physical 
post to conplete. This uill be cleared by the cache con- 
pletor uhen the physical post conpletes. (This is used to 
insure that a cache nove for any subsequent urite request 
uill not be serviced until the physical post conpletes.) 



(9:1) - 



i- 



(10:3) 
(13:3) 



Set if doing sequential I/O. Uhen the request for the 
last area of this dice donain it conpltte, this donain 
uill be rude a ROC. 

■ Not used. 

• STATE 

- WML. CDT is an available entry. 
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Logical Disc Requett Table 

11017 Pointer to Logical Disc Request Table 

NATE: 

This table is really part of the ORQ (Chapter 13). Any entry uith 
the logical request bit set in the flags Mill confom to this for- 
nat and not the fornat of the standard DRQ. 



Logical disc requests entries *r* used to Manage requests between the 
requesting process and a napped disc donain. They art the counterpart of 
disc requests entries used to nanage physical I/O requests betueen a process 
and a disc. These entries arc kept as part of the DRQ Table, but uill never 
be queued to the disc's DIT, instead they Mill be queued to the napped disc 
donain CDT entry. LDR entries nay only be placed onto the following queues: 

1) The CDT active list. 

2) The CDT inpeded LDR list. 

3) The Disabled Disc Request. (This uill only happen if the buffer 
segnent is absent uhen the logical I/O {cache nove) is attested.) 



LDRs are singly linked onto the CDT queues and doubly linked 
onto the disabled disc request queue. 
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logical Disc Request Entry 
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1 



1111 
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1 
2 
3 

4 
5 
6 
7 
Z10 



114 



CI Itl/I CI Dl L 



Tl V|/| Rl SI R 
I l/l I Rl 

HI Dl/I R| Bl R 



Dl 0|/| E| LI E 

El Ml/I Ql El 

I El/I I Dl 



HODA of extent Unit 



flapped Donain CDT entry nunber 
S| DST nunber 



Offset into OST 



Strategy 



I 



Function 



Count/Xlog/Contrc-1 returns 



P1 



I Qualifier I Status 



PIN nunber 



Prev. LDR in queue (table relative) 



Z1S I Next LOR in queue (table relative) 



I- 
116 I 



117 | 

I- 
Z20 | 



HODR of extent base 



LODfl of extent base 
LODA of extent Unit 



LDR' L' HOOP. 

LDR'LDEV 

LDR' CDT 

LDR'BuTDST 

LOR'BUFflOR 

LDR'STRAT'FUNC 

LDR'COUHT 

LOR'PARIH 

L0R'Pfl«12 

LDR'STRTQ 

LDR'PCB 

LDR'PREVO 

LOR'NEXTO 

LDR'B'HODR 

LDR' B' LOOfl 

LDR' L' LOOfl 
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LOR'STRRT'FUNC 
(0:8) - Strategy 

- Unknown caller 

1 - Unknoun File Systen 

2 - Spooler 

3 - Directory 
4-7- Unknoun caller 

8 - Gennessage 

9 - File Systen, fluiesce I/O 

10 - File Systen, Sequential, Ho Buf 

11 - File Systen, Direct, No Buf 

12 - File Systen, Sequential, Buffered 

13 - File Systen, Direct, Buffered 

14 - File Systen, KSHn 

15 - File Systen, IBRGE 

(8:8) - Function 

- Read 

1 - Urite 

LOR'COUNT 

On initiation, this specifies the requested transfer count (+uords, -bytes). 
Rt conpletion of the request, this contains the actual trancnission count 
(tuords, -bytes). 

LOR'PBRm 

This is the High Order Disc Rddress of the requested disc sector. 

L0R'PARH2 

This is the Lou Order Disc Rddress of the requested disc sector. 

LOR'STBTO 

Uniforn status returns. 

LDR'PCB 

PIN of the requesting process. 

LDR'PREVQ 

Table relative index of the previous LDR in the queue. (NOTE: LDRs are sing- 
ly linked on the CDT queues, and doubly linked on the disabled disc request 
queue). 

LOR'HEXTQ 

Table relative index of the next LDR in the queue. 

LOR'B'HODfl 

The High Order Disc Address of the extent base. (Used uhen the logical disc 
request is through the file systen. Caching uses this information uhen 
searching nenory for a "hit" on a cached donain). 

IHR'B'LODR 

The Lou Order Disc Address of the extent base. (See note above). 

IDR'l'LODA 

The Lou Order Disc Address of the extent Unit. (See note above). 
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LDR 'F LAOS 
Flags. 

(0:3) - Hot used. 
(3:1) - S8UF. 

Set if request is tc/fron a Systen Buffer. 
(4:1) - IOUAKE . 

Set if systen should uake up the process uhen the logical 

I/O conpletes. 
(5:1) - BLOCKED . 

Set if the process uants to uait for the logical disc 

request to conplete. 
(6:1) - DONE. 

Set uhen the logical disc request is conplete and the 

process uill be auakened (if IOUflKE is set) 
(7:1) - DO'POST . 

Set if the caller uants to be uaited until the physical 

post to disc conpletes. Only valid for urite requests. 
(8:1) - SERIAL' POST . 

-Set uhen the physical post should be through the Global 

Serial Urite queue. 
(9:1) - COT'QUEUEP . 

This request has been queued - either onto the COT active 

queue (see CDT flapped Donain entries) or onto the disabled 

disc request list. 
(10:1) - noVE'DOHE . 

The nove has been conpleted, but the process uon't be 

auakened until the DONE bit is set. 
(11:1) - Hot used. 
(12:1) - CUR'REQ . 

Set if this request is the current/active request. 
(13:1) - DISABLE . 

Set if the request is disabled. 
(14:1) - LOR 'RED . 

Set if this is a logical disc request. 
(15:1) - LDR'IHLOC . 

Set if [lapped Donain CDT entry is in process's locality 

list. 

LDR'l'HOOA 

The High Order Oisc Rddress of the extent Unit. (See note uith LDR'B'HODR). 

LDR'LDEV 

The Idev for this request. 

LDR' CDT 

The CDT nunber for the Happed Donain entry associated uith this request. 

LDR'BUFDST 

Data Segnent nunber for the target of the logical I/O request. If bit zero 

is set, then this is the process's stack. 

LDR'BUfBOR 

Offset uithin the DST (above) for the target address. If the DST is the 

process's stack, then this address uill be DB relative. 
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CHRPTER 24 NATIVE LANGUAGE SUPPORT 



HL/3O0O Internal Table Structure 



NLS FILE CODES 

LANGDEF.PUB.SYS - 1228 

CHRDEFXX.PUB.SYS - 1229 

NLSDEF.PUB.SYS - 1229 



Native Language Support CNLS) Table Overview 



|-->l LANGUAGE 



ISys Mob Eatn Z12 I > 

| 1 
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Native Language Support 



Native Language Table (NLT) 



This table it created by INITNLS (called by PROGEN). The DST nunber is con- 
tained in SYSGLOB extension Z12. The Native Language Table (NLT) contains 
the description of all the character sets needed to support the installed 
languages, and additional infomation needed to support the configured lan- 
guages (DST nunbers of the languages associated DSTs, character sets, etc.). 

Every installed language has had an associated Language DST, set up by 
INITNLS. 



NLT OVERHEAD TABLE 



I NLT INSTALLED LANGUAGE 
! TABLE 



I NLT INSTHLLED CHARACTER 
I SET TABLE 



I NLT CHARACTER ATTRIBUTE 
I TABLE 
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Native Language Support 



NLT Overhead Table 



The NLT overhead table is 8 uords long. 



Native Language Support 

NLT Installed Language Table Fomat 

For each of the supported non-NATIVE3000 languages there is a 12-uord lan- 
guage entry. 



6 I 



7 I 



.„., I „ L „ 


"T" I ■ " 


LENGTH OF NLT (IN UORDS) 


NUMBER INSTALLED LBNGUBGES 


NUHBER INSTALLED CHAR SETS 


SYSTEM LANGUAGE ID NUNBER 


SYSTEM LANGUAGE LOST 
NUMBER 


RESERVED 




LANGUAGE 10 NUNBER 


LANGUAGE CLASS 


LANGUAGE LDST NUNBER 


CHBRBCTER SET ID NUNBER 



LANGUAGE NRNE 
(8 UORDS) 



-1st SUPPORTED LANGUAGE 
ENTRY 



= 


LANGUAGE ID NUMBER 


LANGUAGE CLASS 


LANGUAGE LDST NUNBER 


CHARACTER SET ID NUMBER 



I 



LANGUAGE NAME 
(8 UORDS) 



-Nth SUPPORTED LANGUAGE 
ENTRY 
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Nit i vi Language Support 
KLT Stalled Character Set Tab It Fornat 



For each eharactar »t installed on the tytttn then is an 11 word character 
tet table. It hat the following fornat: 






CHARACTER SET It NUMBER 


1 


CHARACTER SET TYPE 


2 


POINTER TO CHARACTER 
ATTRIBUTES TABLE 


3 





CHARACTER SET NAI1E 
(S UORDS) 
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NIT Character Attributes Table 



The NLT Character Attributif Table ie conprieed of a table for each con- 
figured character eet. At thia tine, only two character eete are configur- 
able: Claei Four Languages (KAKJI-baeed) and Nonclase four Languages. 



Character type a 1 

->l 256 byte 
| ATTRIBUTE 
I TABLE i 

| 1 



I CHAR SET t 1 
I ATTRIBUTES 



I CHAR SET » 2 
I ATTRIBUTES 



I— -I 

I I 

-I i 

I I 



Character type > 2 



! uord KAHJI 
ATTRUUTE 
TABLE 



The type = 1 attribute table il a 256 byte table. Each byte corresponds to a 
character uith that octal value. 



Attribute 
1 
2 
3 
4 
5 



- nuneric character 

- special character (e.g. "!", M ?" 

- alphabetic uppercase character 

- alphabetic louercase character 

- control code 

- invalid character (unused code) 



'." etc.) 
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Native Language Support 



Language PST 



For each language installed on a target systen (uith the exception of 
NATM-30OO) INITHLS uill build one language DST uith the follouing 
structure: 



Native Language Support 

LOST Overhead table 
The overhead region has the follouing fornat: 



LOST OVERHEAD TABLE 



LUST TRANSLATION TABLES 
(5 subtables) 



LOST CUSTOH DATA TABLES 



LOST NATIONAL SPECIAL 

TABLE 
(an optional table) 



I 
I- 

1 I 



2 I 
I- 

3 ! 



LOST SIZE IN UORDS 



NIT PST NWOtH 



4 I 



7 I 



LOST OFFSET TO CUSTOn 
DATA TABLES 



LOST OFFSET TO NATIONAL 
SPECIAL TABLES 



The national special table is optional. If it does not exist, the pointer to 
it is zero. 



LOST Translation Tables 
For each language a nunber of translation tables are stored: 



LOST UPSHIFT TABLE 
(128 UORDS) 



LOST DOUNSHIFT TABLE 
(128 UORDS) 



LOST ASCII -> EBCDIC 

CONVERSION TABLE 

(128 UORDS) 



LOST EBCDIC -> ASCII 

CONVERSION TABLE 

(128 UORDS) 



LDST COLLATING 
SEQUENCE TABLE 
(class dependent) 
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Native language Support 



LDST Collating Sequence Table 

The LOST Collating Sequence Table is of different fornats depending upon the 
class of the language. 

Overvieu 

Class One Sone languages, nanely American English and Katakana, can be be 
Languages: collated by using the nunerical representation of the ASCII en- 
coding as the sequence nunber for any given character. These 
languages can use the Compare Bytes Machine instruction. 

Class Tho Sone languages nay be able to use the C0B0LII nachine instruc- 

Languages: tion, Conpare-Translated-Strings. These languages need to have a 

one-to-one napping of character encoding to sequence nunber. Any 

algorithm for this class of language nust take into account the 

fact that not all HP 3000s have the C0B0U1 fimuare. 

Class Three nany languages uill not be able to use either of the tactics 
Languages: described above. There are a nunber of language-dependent al- 
gorithm that need to be supported. 

Class Four Sone languages require 16-bit character string encoding. 
Languages: Collating these languages is not supported. The collating se- 
quence table for this class of language is reserved. 



Class One Languages 



Since class one languages uill use the conpare bytes nachine instruction 
(CHPB), the uhole collating sequence table for this class is 3 uords. 



| language ID 
I- 



I language class 
| 
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Class Three Languages 




1 
2 
3 
4 
5 
6 
7 

no 
in 



Table Length (uords) 



LANGUAGE ID 



LANGUAGE CLASS 

11 



256 



Pointer to 2:1 happing Table 



Length of 2:1 happing Table 



Pointer to 1:2 happing Table 



I- 

I Length of 1:2 happing Table 

I- 

I 



lowest char. | highest char, 
sequence value I sequence value 



I I- 
I I 



Sequence Entry ft 
Sequence Entry ft 1 



I I 

Z370I | Sequence Entry ft 255 



I I- 

! | 2:1 Character happing Table 



I I- 

I I 1:2 Character happing Table 



I I- 
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Native Language Support 



|<-0verhead table 



i 
i 

|<-Sequence table 

I 

I 



Native Language Support 
Class Two Languages 



This sequence table has a 13-uord over head table and a 128-uord sequence 
table. 





1 

2 

3 

4 

5 

6 

7 
X10 
Z11 

212 
Z13 



X212 



139 


LANGUAGE ID 


LANGUAGE CLASS 


11 


128 














louest char. I 
sequence value I 


highest 
sequence 


char. 

value 


reserved 


sequence M I 


sequence 


• 1 


sequence ft 2 I 


sequence 


ft 3 


I 







< -Overhead table 



1 

sequence ft 254 I sequence ft 255 t< 



I 
I 

I < -Sequence table 
I 

I 



Note: Uord Z11 of the overhead contains in the left byte the the character 
value, uhich has the louest sequence nunber and in the right byte the 
character value, uhich has the highest sequence nunber. 

In the 128-uord sequence table, the byte value of the character is 
used as a byte pointer in the collating table. 

The byte value of the character is used as a byte pointer collating 
entries. 
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Native Language Support 
Class Three Languages fCont.1 



I — node — ! 
7 8 9 15 



I I 



OR 



j These characters uill 
j be ignored when sorted. 



j a n 1:1 napping 

i sequence ft I I I characters 

j 1 without case or 

accent priority 
OR 

| 1 1:1 napping 

I sequence ft I I priority I characters uith 

j | case or accent 

priority 



sequence ft I 1 I index I 2:1 napping 
1 characters 



I seq. ft of 1. I 2 I index I 1:2 napping 

j | characters 

The bvte value of the character is used as an index to the sequence entries. 
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MUt* Ungu<|i Support 



1:1 Chtrtettr napping table 



8:1 napping entry > 



<n-1)*2 

(n-1)«2»1 

n«2 

n*Z+1 








71 1 


1 0| U9tl char 1 


1 I Mq 


« of 


pair| nod( of pair 









I 1(9(1 char n | 
-I 



uq.H of p»lr| node of piir I 

"l 

-I 



I node nun nttcn i 
1 



I WOE ■ 

7 t 9 10 



I I 



i— — indtx/typt 
priority 
(bit! 10:6) 

rred( type (0,1, or 
(bit* 8:2) 



Entry has sane fornat (■ nod* option, in th( LOST Collitino Sequence Tabla 
Fornat for Class Three languages. 



N«U« Language Support 
lit Charectjr I1«ppin| Table 



! »__ J I » II 

Mil napping nitty I — > (tq,« of 2nd I nodi of both 



1 «q.» of 2nd I node of both 



| . 1 

n I (Hi.* of 2nd | nodi of both I 
| 1 



I WOE 1 

7 I 9 10 15 



I I 



i- — -- index/type 
priorit 
(biti 1' 



priority 

'■'■ 10:6) 



■ nodt typt (0,1,or 
(bit. 8:2) 
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Entry hu on fornat <■ one above. 
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Class Four Languag es 



Class four languages require 16-bit character encoding. Sorting in dan 
four languages is not inplenented in this release of HLS. A prelininary col- 
lating sequence table is planned to be 8 uordt in length. 



I- 



I Address on disc - Pattern 1 | 



— I 



1 I Address on disc - Pattern 2 | 



-I 



7 I Address on disc - Pattern 8 



I- 



Kative language Support 



IDST Custon Data Table Fortiat 

This table is 196 uords long. The fornats and information in this table are 
language dependent, and nay be nodified uith UW6IHST.PUB.SVS. 



LOST CALENDAR SKELETON | 

(9 uords) | 



I0ST CUSTOtl DATE SKELETON I 
(13 bytes) ( 



LOST TWE SKELETON 
(4 uords) 



LOST fB8P.EVIP.TED HOHTH NANES 
(24 uords) 



LOST FULL IWNTH KMIES 
(122 uords) 



LOST ABBREVIATED UEEKOW NAUES 
(21 bytes) 



127 | LOST FULL UEEKDAY NFfflES 

I (42 uords) 

169 | LOST YES/NO CHARACTER STRINGS 

I (S uords) 



175 | LOST THOUSANDS INDICATORS 
I (1 uord) 



LOST CURRENCY SYH60L 
(5 bytes) 



LDST RESERVED 
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Hative language Support 

LOST National Special Table 

This table it optional and its existence if signaled by a nonzero pointer in 
the LOST overhead region. It is used to store data unique to a given language 
— e.g. the Enperor data the for the Japanese calendar. 



Length 



-I 



national 
dependent 
data 



Date Fomats for Japan and Tainan 



For a given language, there is only one date Fomat possible. The fomat of 
the year stored in the date fomat of the LOST can either be yyyy or yy for 
the Julian dates or Nyy for either the Japanese date (Enperor Era)- or the 
Taiuanese date foundation of republic date). 

If the fomat of the year stored as the date fomat in the LOST is Nyy then 
either the Japanese enperor dates or the Taiuanese foundation date has to be 
stored in the national dependent table. 
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Japanese Date Fgmat 



There are three entries uhich do not change. The user can add neu entries. 
These entries have to be stored in ascending order sorted by word 1 . 



The values of the entries are: 

starting date octal value 
(NOV) 



starting enperor synbol 
year 



1/ 1/1873 
7/30/1912 
12/2S/1926 



Z1 
114324 
Z32547 



Z41 
l\ 
%1 



Native Language Support 



National Dependent Table Fomats 



20 


length of table(uords) 


Z1 


id 


K 


nunber of entries 


13 


nun of HP supplied entr. 


M ♦ XS 


period entry 1 


■ 


tx e 


(2n*S) ♦ 
(»i*3) 


period entry n 



The period entries are two word entries of the following fomat: 



6 7 



year of I day of the j uord 1 (starting date) 
century | yetr ! 



starting j enperor | uord 2 
year j synbol j 



The ID for Japanese and Taiuanese date fomats is always set to 1. 



* since this starting tine is in the 19 th century and ue are not able 
to handle dates before 1900 easily, ue store 3.1 as starting tine. 



For neu date entries created by the custoner the starting year uill 
aluays be 1. 
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Taiuanese Date Fomat 



There »n tuo entries for the Taiuanese national dependent table. 
The values of the entries 9rt: 



Starting date Octal value 

(HOY) 



Starting Enperor synbol 
Year 



1/ 1/1900 

1/ 1/1912 



X1 
114001 



XQ 
X1 



Z40 



The user does not need to add neu entries. 
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We welcome your evaluation of this manual. It is one of several that serve as a reference source for 
HP 3000 Computer Systems. Your comments and suggestions help us to improve our publications and 
will be reviewed by appropriate technical personnel. HP may make any use of the submitted sugges- 
tions and comments without obligation. 



Is this manual technically accurate ? Yes [] No [] 

Are the concepts and wording easy to Yes [] No [] 

understand ? 

Is the format of this manual convenient Yes [] No [] 

in size , arrangement and readability ? 



(If no, explain under Comments, below.) 
(If no, explain under Comments, below.) 



(If no, explain or suggest improvements 
under Comments, below.) 
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